home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 / Aminet - June 1993 [Walnut Creek].iso / ab20 / archivrs / lha_e111.run / LhA.man < prev    next >
Encoding:
Text File  |  1992-01-20  |  106.9 KB  |  2,942 lines
  1.  
  2.  
  3.      
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                               LhA User's Guide
  15.  
  16.                         Version 1.11 - January 1992
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.             /~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\
  30.             /~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\
  31.             /~~\___________________________________________/~~\
  32.             /~~\___________________________________________/~~\
  33.             /~~\__/~~\_________/~~\___________/~~~~~~~~\___/~~\
  34.             /~~\__/~~\_________/~~\__________/~~~~~~~~~~\__/~~\
  35.             /~~\__/~~\_________/~~\__________/~~\____/~~\__/~~\
  36.             /~~\__/~~\_________/~~\__________/~~\____/~~\__/~~\
  37.             /~~\__/~~\_________/~~~~~~~~~\___/~~~~~~~~~~\__/~~\
  38.             /~~\__/~~\_________/~~~~~~~~~~\__/~~~~~~~~~~\__/~~\
  39.             /~~\__/~~\_________/~~\____/~~\__/~~\____/~~\__/~~\
  40.             /~~\__/~~\_________/~~\____/~~\__/~~\____/~~\__/~~\
  41.             /~~\__/~~~~~~~~~\__/~~\____/~~\__/~~\____/~~\__/~~\
  42.             /~~\__/~~~~~~~~~\__/~~\____/~~\__/~~\____/~~\__/~~\
  43.             /~~\___________________________________________/~~\
  44.             /~~\___________________________________________/~~\
  45.             /~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\
  46.             /~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                           Written by Stefan Boberg
  57.                    Copyright (c) 1991,92 by Stefan Boberg
  58.  
  59.  
  60.      
  61.  
  62.  
  63.      V1.11                    LhA User's Guide                   Page 1
  64.  
  65.  
  66.      1 - Introduction      
  67.  
  68.         LhA is  a  new  and  powerful  archiver for the Commodore-Amiga
  69.      computer.  It  is  fully compatible with LHA for MSDOS systems and
  70.      LhArc  for  MSDOS, Amiga and *NIX.  It is also compatible with LZ,
  71.      LhArc  and  LhArcA  for the Amiga. LhA sports fast compression and
  72.      decompression  and  has  several commands and options not found in
  73.      any other archiver currently available archiver for the Amiga.  
  74.  
  75.      1.1 About the manual     
  76.  
  77.         The manual  is  divided  into three sections, the first section
  78.      (this  one)  contains  some information related to the program and
  79.      how it compares to other similar products.  
  80.  
  81.         The second  section is a reference section, where all features,
  82.      commands  and  options are explained thoroughly.  The last section
  83.      contains   the   license   agreement,   registration  details  and
  84.      disclaimers.  
  85.  
  86.      1.2 System requirements      
  87.  
  88.         LhA will  run  on  any Amiga system with at least 512KB RAM and
  89.      one  diskdrive,  though 1MB RAM and two diskdrives or harddrive is
  90.      recommended  to  get  the  most  out  of LhA.  LhA will run on any
  91.      KickStart  from  version  1.2  and up.  If LhA is used on a system
  92.      with  the  new  KickStart  2.x  it  will adapt to this and utilize
  93.      features  new to this release.  Special care has been taken in the
  94.      program  design to make the program execute as fast as possible on
  95.      68020,   030   and   040-processors   without   sacrificing  68000
  96.      compatibility.  
  97.  
  98.         Currently, LhA requires `arp.library'.  
  99.  
  100.      1.4 Terminology       
  101.  
  102.      ARCHIVE  -  An archive is a file containing one or more files in a
  103.      compressed  or  non-compressed  state and related information like
  104.      file names, last modification date/time, filenotes etc.  
  105.  
  106.      COMPRESSION  -  The process of encoding redundant information into
  107.      data  requiring less storage space.  There are a multitude of ways
  108.      you  can  do  this  in.  LhA uses a modified version of Lempel-Ziv
  109.      compression  with  block-adaptive  Huffman coding and a dictionary
  110.      size of 4096 or 8192 characters.  
  111.  
  112.      COMPRESSION  RATIO - The compression ratio figures reported by LhA
  113.      are  calculated  as  follows:   ratio  =  (1  - (CompressedSize) /
  114.      (OriginalSize))  * 100.  I.e how many percent of the file that was
  115.      GAINED.   Other  archivers may use other methods.  LHA and ARJ for
  116.      MS-DOS,   for   example,   calculates   the   ratio  as:  ratio  =
  117.      (CompressedSize)  / (OriginalSize), i.e.  how large the compressed
  118.  
  119.  
  120.      
  121.  
  122.  
  123.      V1.11                    LhA User's Guide                   Page 2
  124.  
  125.  
  126.      file   is   compared   to   the   original  file.   (MSDOSratio  =
  127.      1-(ADOSratio/100)).   The higher the LhA compression ratio is, the
  128.      better  the  compression.  Most Amiga archivers use the same ratio
  129.      calculation method as I use.  
  130.  
  131.      EXTRACTION  or DECOMPRESSION - The process of recreating the exact
  132.      information   that   was  previously  compressed  (file  contents,
  133.      modification   date,   filenotes,   protection   flags,  directory
  134.      structure etc.) 
  135.  
  136.      SELF-EXTRACTION  MODULE  (SFX-Module) - This is an archive that is
  137.      an executable file capable of extracting self-contained files.  
  138.  
  139.  
  140.      1.5 LhA - what is it?   
  141.  
  142.         LhA is  a  file  archiving  program  written especially for the
  143.      Commodore  Amiga  computer.  The  primary  goal  is to provide the
  144.      Amiga   community   with  a  fast,  efficient  and  reliable  file
  145.      archiver.  LhA creates and processes archive files with the '.LZH'
  146.      suffix,  and  is  fully compatible with both MSDOS LhArc and MSDOS
  147.      LhA,  as  well as the Amiga LhArc, LZ, and LhArcA. It handles both
  148.      the  old  LhArc-style  compression  (-lh1-,  -lh0-)  and  the  new
  149.      LHA-style (-lh5-, -lh4-).  
  150.  
  151.         LhA is  at the time of release by far the fastest LhArc archive
  152.      handler,  and  is more reliable and robust than both LZ and LhArc.
  153.      Neither  LZ  nor  LhArc  even comes close to the speed of LhA. The
  154.      compression  and  decompression  routines  are written entirely in
  155.      what   I'd  call  very  optimized  68000  assembly  language.  The
  156.      routines   were  written  directly  from  scratch  in  pure  68000
  157.      assembler,  and  did  not,  as  in  the other Amiga LZH-archivers,
  158.      start  as  a compiled C-program. Because of this, the routines are
  159.      both  smaller  and,  more importantly, faster than they would have
  160.      been  if  I'd used compiler output as source material. You can get
  161.      an  idea of how fast LhA is compared to other archivers by looking
  162.      at  the  speed  test  results  in section 1.7.1 of this manual. An
  163.      even better way to see how fast LhA is, is to try it yourself! 
  164.  
  165.         Before writing  this  program I used LhArc a lot, to archive my
  166.      source  codes  automatically  for  example.  But since LhArc often
  167.      behaved  in  a  very  weird  way when updating archives, sometimes
  168.      adding  files  twice,  and  sometimes  not  adding files at all, I
  169.      decided  to write an archiver of my own. And this is the result...
  170.      LZ  was no alternative since it did not have the commands I needed
  171.      (u,f) and was very unreliable at the time.  
  172.  
  173.      1.6 What is a file archiver anyway?  
  174.  
  175.         A file  archiver,  as  the  name  implies,  archives  files. It
  176.      collects  the  files  you  specify and stores them all in a single
  177.      archive-file.  Almost  all  file  archivers  (including  LhA) also
  178.  
  179.  
  180.      
  181.  
  182.  
  183.      V1.11                    LhA User's Guide                   Page 3
  184.  
  185.  
  186.      compress  the  files  before  putting them in the archive-file, so
  187.      that  they  occupy  less diskspace. When you wish to retrieve some
  188.      file  from  the  archive,  the  archiver decompresses the file and
  189.      restores  it's file attributes (Last modification date, time, file
  190.      comments,  protection  status  etc.).  A file archiver can usually
  191.      also  process archive files in different ways, for instance delete
  192.      files,   freshen   files,  print  files  etc.  See  the  'ARCHIVER
  193.      COMMANDS'  section  of  this  manual  for  an  explanation  of the
  194.      different actions LhA is capable of performing.  
  195.  
  196.         The most  common  use  for  a file archiver is for transferring
  197.      several  related  files  via modem. It would be a very tedious and
  198.      cumbersome  task to transfer for instance every single source file
  199.      of  a  big  project  separately,  so why not put them all into one
  200.      single  file?  This is where the file archiver comes in, we simply
  201.      feed  the  archiver  with  all  the files we wish to transmit, and
  202.      then  just  transfer  the  single  archive-file  the  achiver then
  203.      creates!  Then  the  receiver just use the archiver to extract all
  204.      files  from  the archive-file onto his harddisk (or floppy). Also,
  205.      if  the  files were compressed by the archiver, it would take less
  206.      time  to  transfer  the  files  as well, which means the phonecall
  207.      will  cost  us  less.   There  are of course other uses for a file
  208.      archiver,  you can use it as a harddisk-backup program for example
  209.      (if  you  have another harddisk to put the archive file on..), and
  210.      you  can  use it to stuff away files you don't use very often, and
  211.      then  when  you want to use them you simply extract the files from
  212.      the  archive,  and  then  delete  them when you're finished (saves
  213.      disk  space). Personally I use LhA a lot to make automatic backups
  214.      of my source codes for various projects.  
  215.  
  216.         The file  compression  methods  vary  from  very  simple,  less
  217.      effective,  and  fast (Run-Length Encoding, RLE, for instance), to
  218.      complex,   effective   and   relatively   time-consuming   methods
  219.      (Lempel-Ziv-Huffman,  LZHUF,  as  used in LhA). The method used in
  220.      LZH-Archivers  (LZHUF) is to date probably the best algorithm used
  221.      in  an  archiver.  There  are other similar methods, like ZIP, but
  222.      they  are  not  as  good. Even though the files become smaller you
  223.      don't  lose any information when compressing them, the information
  224.      is   just   stored   in  a  different  way.  Basically,  redundant
  225.      (repeated)  information  is  replaced with a pointer to some other
  226.      part  of  the file, where this information is located. For example
  227.      in  this  text  the word 'archive' appears at several places, this
  228.      is  an example of redundant data. Simply put, if a file compressor
  229.      was  to  compress  this  file  it would let the first occurence of
  230.      'archive'  remain  unchanged,  and then it would replace all other
  231.      occurences  of  'archive'  with  a  pointer to the first one. When
  232.      decompressing  the  file,  the  archiver  uses  these  pointers to
  233.      restore the file to its original state.  
  234.  
  235.         Files which  have  already  been  compressed with one technique
  236.      can  generally  not  be  compressed any further by feeding them to
  237.      the  same  file  compressing  program  again  (If  that  had  been
  238.  
  239.  
  240.      
  241.  
  242.  
  243.      V1.11                    LhA User's Guide                   Page 4
  244.  
  245.  
  246.      possible,  modem transfers would have been a lot cheaper :), since
  247.      the  redundant  information  has  already  been  eliminated. It is
  248.      possible  though  to  compress files output by certain compressors
  249.      (RunLength-Encoders  for  example)  further  by  feeding them to a
  250.      program   that  uses  another  method  (like  LZHUF),  since  they
  251.      eliminate different kinds of redundant information.  
  252.  
  253.      1.7 Why should I use LhA?   
  254.  
  255.         There are  several  reasons  why  you should use LhA instead of
  256.      other archivers for the Amiga; here are some examples: 
  257.  
  258.  
  259.      1)  It  extracts  files  faster  than  any other popular archiver,
  260.         including LZ, Zoo, LhArcA, PkAZip, Pkax, Arc, and Ape.  
  261.  
  262.      2)  It  compresses  files faster than any other archiver, with the
  263.         exception  for  Zoo  V2.01,  which  has much looser compression
  264.         ratio and thus produces much larger archives.  
  265.  
  266.      3)  It  produces smaller archives than any other archiver. Both LZ
  267.         V1.92  and  Zoo V2.10 produces archives which are approximately
  268.         the  same size, but are much slower than LhA on both extraction
  269.         and compression.  
  270.  
  271.      4)  LhA  has  a  number of features that no other archiver for the
  272.         Amiga  has,  for  example  the  ability  to create and maintain
  273.         multiple-volume archives.  
  274.  
  275.  
  276.      1.7.1 How fast is it?    
  277.  
  278.         The following    tables    compares   LhA's   compression   and
  279.      decompression  with  several  other  archivers.  The T field shows
  280.      compression or decompression time in seconds and 
  281.  
  282.        T(archiver)
  283.      Q=-----------  i.e. how much longer the archiver takes compared
  284.         T(LhA_lh5)  to LhA in -lh5- mode. For example, A Q value of 2
  285.      means  that the archiver in question takes twice as long as LhA in
  286.      -lh5-  mode  to  extract/compress  all files.  The tests were made
  287.      with  a  A3000/25Mhz/4M  SCRAM/2M CHIP and with all files in RAM:.
  288.      A  special  program  (`time')  was  used to measure execution time
  289.      with  the `timer.device'.  The times exclude loading and unloading
  290.      time  to  more  accurately  reflect  the actual program speed. All
  291.      tests  were  made  with  the  programs  in  their  default mode of
  292.      operation,  except  for  LhA  `max' where the optimal command line
  293.      parameters for the files were chosen by hand (-v0 -Qh64).  
  294.  
  295.                               Extraction speed
  296.  
  297.                         Archive: `the brown corpus'
  298.  
  299.  
  300.      
  301.  
  302.  
  303.      V1.11                    LhA User's Guide                   Page 5
  304.  
  305.  
  306.          Type: 3.2MB of text, binary and graphics data in 21 files
  307.  
  308.          +-----+-----+-----+-----+-----+-----+-----+-----+------+------+
  309.          | LhA | LZ  | LhA | LZ  |LhArc| Zoo |Zoo  | Zoo |PkAZip| Pkax |
  310.          |     |V1.92|     |V1.92|     |V2.01|V2.1 |V2.1 |V1.02 | V1.0 |
  311.          |-lh5-|-lh5-|-lh1-|-lh1-|-lh1-| old |old  |-lh5-| imp. |crunch|
  312.       +--+-----+-----+-----+-----+-----+-----+-----+-----+------+------+
  313.       |T |13.3 |27.0 |36.0 |51.2 |90.5 |24.2 |76.1 |57.5 | 45.0 | 51.1 |
  314.       +--+-----+-----+-----+-----+-----+-----+-----+-----+------+------+
  315.       |Q | 1.00| 2.03| 2.71| 3.85| 6.80| 1.82| 5.72| 4.32|  3.38|  3.84|
  316.       +--+-----+-----+-----+-----+-----+-----+-----+-----+------+------+
  317.  
  318.                            Archive: `dlgmsgs.lha'
  319.                            Type: 760K text file.
  320.          +-----+-----+-----+-----+-----+-----+-----+-----+------+------+
  321.          | LhA | LZ  | LhA | LZ  |LhArc| Zoo |Zoo  | Zoo |PkAZip| Pkax |
  322.          |     |V1.92|     |V1.92|     |V2.01|V2.1 |V2.1 |V1.02 | V1.0 |
  323.          |-lh5-|-lh5-|-lh1-|-lh1-|-lh1-| old |old  |-lh5-|impld.|crunch|
  324.       +--+-----+-----+-----+-----+-----+-----+-----+-----+------+------+
  325.       |T | 3.1 | 6.4 | 9.2 |13.1 |21.8 | 5.9 |19.3 |14.1 | 11.2 | 13.8 |
  326.       +--+-----+-----+-----+-----+-----+-----+-----+-----+------+------+
  327.       |Q | 1.00| 2.07| 2.97| 4.23| 7.03| 1.90| 6.22| 4.54|  3.61|  4.45|
  328.       +--+-----+-----+-----+-----+-----+-----+-----+-----+------+------+
  329.  
  330.                              Compression speed
  331.  
  332.                         Archive: `the brown corpus'
  333.          Type: 3.2MB of text, binary and graphics data in 21 files
  334.  
  335.          +-----+-----+-----+-----+-----+-----+-----+------+------+------+
  336.          | LhA | LZ  | LhA | LZ  |LhArc| Zoo | Zoo |PkAZip|LhArcA| LhA  |
  337.          |     |V1.92|     |V1.92|     |V2.01|V2.1 |V1.02 |V1.01 | V1.0 |
  338.          |-lh5-|-lh5-|-lh1-|-lh1-|-lh1-| old |-lh5-| imp. |-lh1- | max  |
  339.       +--+-----+-----+-----+-----+-----+-----+-----+------+------+------+
  340.       |T | 208 | 396 | 205 | 285 | 571 | 76  | 512 | 394  | 386  |  206 |
  341.       +--+-----+-----+-----+-----+-----+-----+-----+------+------+------+
  342.       |Q | 1.00| 1.90| 0.99| 1.37| 2.75| 0.37| 2.46|  1.89|  1.86|  0.99|
  343.       +--+-----+-----+-----+-----+-----+-----+-----+------+------+------+
  344.  
  345.          Resulting sizes :   LhA    -lh5-   1139622  1.0000
  346.                              LZ     -lh5-   1139178  0.9996
  347.                              LhA    -lh1-   1199680  1.0527
  348.                              LZ     -lh1-   1199209  1.0523
  349.                              LhArc  -lh1-   1248729  1.0957
  350.                              LhArcA -lh1-   1248729  1.0957
  351.                              PkAZip Impl.   1196698  1.0501
  352.                              Zoo    -lh5-   1140114  1.0004
  353.                              Zoo      old   1491922  1.3091
  354.                              LhA     max    1136244  0.9970 (-Qh64)
  355.  
  356.                            Archive: `dlgmsgs.lha'
  357.                            Type: 760K text file.
  358.  
  359.  
  360.      
  361.  
  362.  
  363.      V1.11                    LhA User's Guide                   Page 6
  364.  
  365.  
  366.  
  367.          +-----+-----+-----+-----+------+-----+------+------+------+
  368.          | LhA | LZ  | LhA | LZ  |LhArc | Zoo | Zoo  |PkAZip|LhArcA|
  369.          |     |V1.92|     |V1.92|      |V2.01|V2.1  |V1.02 |V1.01 |
  370.          |-lh5-|-lh5-|-lh1-|-lh1-|-lh1- | old |-lh5- |impld.|-lh1- |
  371.       +--+-----+-----+-----+-----+------+-----+------+------+------+
  372.       |T |30.5 |78.0 |39.8 |63.4 |115.4 |15.8 |120.8 | 45.3 | 84.1 |
  373.       +--+-----+-----+-----+-----+------+-----+------+------+------+
  374.       |Q | 1.00| 2.56| 1.30| 2.07|  3.78| 0.52|  3.96|  1.49|  2.76|
  375.       +--+-----+-----+-----+-----+------+-----+------+-------------+
  376.  
  377.          Resulting sizes :   LhA    -lh5-   274648  1.0000
  378.                              LZ     -lh5-   274635  1.0000
  379.                              LhA    -lh1-   293076  1.0671
  380.                              LZ     -lh1-   293084  1.0671
  381.                              LhArc  -lh1-   303100  1.1036
  382.                              LhArcA -lh1-   303100  1.0957
  383.                              PkAZip Impl.   278837  1.0153
  384.                              Zoo    -lh5-   274839  1.0001
  385.                              Zoo     old    420212  1.5300
  386.                              LhA     max    273383  0.9954  (-Qh64)
  387.  
  388.  
  389.  
  390.      1.8 Compatibility and Amiga-specific features    
  391.  
  392.         LhA is  aimed  at full compatibility with LHA V2.13 for MS-DOS,
  393.      which  is  an improvement of the original LhArc V1.13. LhA is also
  394.      compatible  with  LhArc,  LhArcA  and  LZ  for the Commodore Amiga
  395.      computer.  However,  LhArc  and LhArcA cannot process any archives
  396.      with  headers  of  level  1 or 2, or files compressed with the new
  397.      LHA  compression  (-lh5-).  LZ  1.92  cannot process archives with
  398.      headers  of level 2. LHA V2.13 can process all archives created by
  399.      LhA.  
  400.  
  401.         The OS-ID  stored  in  level  1  and level 2 headers is `A' for
  402.      Amiga. The only OS-IDs I know of currently are: 
  403.  
  404.            ID Operating system 
  405.           --- ---------------- 
  406.           `A' AMIGA 
  407.           `F' OS-9 / FLEX 
  408.           `H' Human68K 
  409.           `K' OS-9 / M68K 
  410.           `M' MS-DOS 
  411.           `m' Mac OS 
  412.           `U' UNIX 
  413.           `2' OS/2 
  414.           `3' OS-386 
  415.           `9' OS-9 
  416.  
  417.  
  418.  
  419.  
  420.      
  421.  
  422.  
  423.      V1.11                    LhA User's Guide                   Page 7
  424.  
  425.  
  426.         The OS-ID  indicates  on  what operating system the archive was
  427.      created.  If  an  entry in an archive has an OS-ID other that `A',
  428.      LhA  will  ignore the file attributes and other OS-specific fields
  429.      and  use  the  default  attribute / whatever. If LhA encounters an
  430.      extended  data-field it does not recognize it issues a warning and
  431.      continues  processing.  The  warning  does not generate any return
  432.      code (if nothing goes wrong LhA returns 0 as the return code).  
  433.  
  434.  
  435.         The LhA-specific  extended  data  structures in the level 2 and
  436.      level 1 headers are laid out as follows: 
  437.  
  438.                             +------------------+
  439.                             |   DISPLAY FILE   |
  440.                             |------------------|
  441.                             | 0x0003 [Length]  |
  442.                             | 0x70   [ID Byte] |
  443.                             +------------------+
  444.  
  445.      This extension is used to flag files that should be displayed upon
  446.      extraction.
  447.  
  448.                             +------------------+
  449.                             |    FILENOTE      |
  450.                             +------------------+
  451.                             | WORD   [Length]  |
  452.                             | 0x71   [ID Byte] |
  453.                             | char[] [Notestr] |
  454.                             +------------------+
  455.  
  456.      Obviously,  this  extension  is used to store filenotes in level 1
  457.      and  level  2  headers.. In level 0 headers the filenote is stored
  458.      in another way.  
  459.  
  460.                                     NOTE
  461.  
  462.           The  evaluation version of LhA is currently only able to
  463.           create archives with headers of level 0.  
  464.  
  465.  
  466.      1.9 About the author program history and future 
  467.  
  468.         I, Stefan  Boberg  -  the  author  of  the  programs in the LhA
  469.      family,  am  19  years  old  and  studying  `applied  physics  and
  470.      electrical  engineering',  first  year, at the Linköping Institute
  471.      of  Technology.  I started working on LhA mainly because I thought
  472.      there  was  no  real  good  archiver  for the Amiga, the ones that
  473.      existed  at  the  time  (June 1991) I began work on it were either
  474.      too  slow, had loose compression ratios or were bugged/crippled so
  475.      that  they  could  not  do what I needed an archiver to do.  I use
  476.      archivers  mainly  to  back  up sources for my various programming
  477.      projects   automatically,  and  I  also  use  it  a  lot  to  just
  478.  
  479.  
  480.      
  481.  
  482.  
  483.      V1.11                    LhA User's Guide                   Page 8
  484.  
  485.  
  486.      decompress  archives  from  bulletin  board  systems  and computer
  487.      networks.  Another  reason for doing it was to earn a little extra
  488.      money,  which  I  badly  need, being a poor student with a _small_
  489.      allowance..  :) 
  490.  
  491.         Anyway, I  intend  to  continue  developing LhA and the related
  492.      programs  as  long  as  I  can,  and  will release other, related,
  493.      programs  as well, like an intuition- driven archiver called `LhI'
  494.      for  instance.  A  file  system to enable you to treat archives as
  495.      directories  is also in the pipeline and will be released sometime
  496.      in  1992.  Other archive formats than LhA-style archives will also
  497.      be  supported  in  the filesystem and intuition driven archiver by
  498.      means  of special resident libraries and handlers. When these will
  499.      be  finished  depends  on how much time I can devote to developing
  500.      the programs (have to take care of my studies you know).  
  501.  
  502.         But this  all  depends  on  YOU,  if  I get a good response and
  503.      people  register  I  will  continue  work on the program.  If not,
  504.      well,  then  I  might as well drop it for other projects, and just
  505.      make  minor  bugfixes  to  it instead of continuing development...
  506.      It's  your  choice!   If  you  would like to express your opinions
  507.      about  the  program,  or  have an idea for a feature you'd like to
  508.      see  in  the  next  version,  please drop me a line via EMail (see
  509.      section  3  for  addresses)  or  write  a  letter.  I would really
  510.      appreciate  it!   You MUST report any bugs you find (though I hope
  511.      you won't find any), so I can fix it right away! 
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.      
  541.  
  542.  
  543.      V1.11                    LhA User's Guide                   Page 9
  544.  
  545.  
  546.      2 Reference guide      
  547.  
  548.         This section  of  the manual is intended to be used mostly as a
  549.      reference  guide  when  you  want  to  know  exactly how a certain
  550.      option  or  command  works.   If  you haven't used LhA before (but
  551.      used  other  archivers),  you  should  at least glance through the
  552.      descriptions  of  all  the  commands and options to get an idea of
  553.      what LhA can do.  
  554.  
  555.      2.1 Command line syntax     
  556.  
  557.         The command line syntax is as follows: 
  558.  
  559.      LhA  [-options]  <Command>  <Archive> [[HomeDir] FileSpec] [@file]
  560.      [destdir] 
  561.  
  562.         The items  in  square  brackets  are optional, and the items in
  563.      angle  brackets  are  mandatory.   Read the following sections for
  564.      exact information on the various items.  
  565.  
  566.  
  567.      2.1.1 Specifying options      
  568.  
  569.         Unlike other  archivers,  LhA lets you specify options anywhere
  570.      on  the  command  line.   The  option specifier is `-' (dash), any
  571.      items  on  the  command  line  that begins with this character are
  572.      considered  to  be  option  switches.   If  you  want to specify a
  573.      filename  or  something  else  that  begins  with a `-' character,
  574.      enclose  the  name  in  double  quotes  or use double dashes.  For
  575.      example,  to  specify  a  filename  of  `-minus',  you could write
  576.      either `"-minus"' or `--minus'.  
  577.  
  578.         If you  write  `-o' the option `o' is enabled regardless of its
  579.      initial  state.   If  you  want to disable an option, append a `0'
  580.      (zero)  after the option, like in `-o0'.  If an option is followed
  581.      by any other numeric character than `0', the option is enabled.  
  582.  
  583.         You can  specify  multiple  options  without  having  a dash in
  584.      front  of  every  option  character.  An example would be `-ox0m',
  585.      which  would  enable  option  `o',  disable  option `x' and enable
  586.      option  `m'.   The  only  exception  is options taking multi-digit
  587.      numeric  arguments,  which  must  be  followed  by  whitespace and
  588.      another  dash  if  you want to specify more options (like in `-b32
  589.      -ox0m').  
  590.  
  591.      2.1.2 Specifying commands      
  592.  
  593.         The first  non-option  argument on the command line MUST be the
  594.      command  specifier.   The commands are case-insensitive (`l' means
  595.      the  same  thing  as  `L'),  and  only  the first character of the
  596.      argument  is  considered  (except  for  the  `vv',  `mb'  and `mf'
  597.      commands),  so  you  may  use  verbose  commands such as `list' or
  598.  
  599.  
  600.      
  601.  
  602.  
  603.      V1.11                    LhA User's Guide                  Page 10
  604.  
  605.  
  606.      `add' instead of `l' and `a', respectively.  
  607.  
  608.      2.1.3 Specifying archives      
  609.  
  610.         The archive   specification   must  be  the  second  non-option
  611.      argument  (the  first  being  the command specification).  In most
  612.      cases  you  can  specify  a pattern here.  The exception being the
  613.      `m' (move files to archive) command.  
  614.  
  615.      2.1.4 Specifying action files     
  616.  
  617.         The action    files    are    specified   after   the   archive
  618.      specification.  The action file specifications may include pattern
  619.      matching  tokens.  Note  that, as all other file specifications in
  620.      LhA,   action   file  specifications  may  contain  wildcards  for
  621.      directory   names   as  well  -  `hd:*/*/dir/*.h'  is  valid,  for
  622.      example.  
  623.  
  624.                                     NOTE
  625.  
  626.           If  you  do  not  specify  any action files, LhA assumes
  627.           that  you  wish  to act upon all files in the archive or
  628.           in the current directory.  
  629.  
  630.  
  631.      2.1.5 Home directories      
  632.  
  633.         Home directories  is  a  new  concept  introduced  with LhA, it
  634.      provides  an  easy  way of specifying what parts of pathnames that
  635.      should  be  preserved  in  the  archive.  It  can  also be used to
  636.      simplify  specifications  of  mutiple files in the same directory.
  637.      It is perhaps best explained with a couple of examples: 
  638.  
  639.       EXAMPLE 
  640.  
  641.        Example 1: 
  642.  
  643.        lha   -x   a  newarc  dh0:files/  file1  dir1/file2  dir2/file3
  644.        dh0:files2/ *.c 
  645.  
  646.        This would add the following files to `newarc.lha': 
  647.  
  648.         Added file(s)         Stored as 
  649.         -----------------     -------------- 
  650.         dh0:files/file1       file1 
  651.         dh0:files/dir1/file2  dir1/file2 
  652.         dh0:files/dir2/file3  dir2/file3 
  653.         dh0:files2/*.c        *.c 
  654.  
  655.        Example 2: 
  656.  
  657.        lha -r a newarc hd:tmp/ *.c *.h hd:px/ *.s *.snd *.iff 
  658.  
  659.  
  660.      
  661.  
  662.  
  663.      V1.11                    LhA User's Guide                  Page 11
  664.  
  665.  
  666.  
  667.         This would  add  all  `.c' and `.h' files in `hd:tmp' and it's
  668.        subdirectories,  storing  pathnames, but excluding the `hd:tmp'
  669.        part.   For  instance, the file `hd:tmp/src/foo/arargh.c' would
  670.        be  stored  in  the  archive  with the name `src/foo/arargh.c'.
  671.        Additionally,  all `.s', `.snd' and `.iff' files in `hd:px' and
  672.        its  subdirectories  will be added, excluding the `hd:px/' part
  673.        of the name.  
  674.  
  675.         Homedir specifications  must  end in `/' or `:', otherwise they
  676.      won't be recognized as such.  
  677.  
  678.         Homedir specifications  may contain wildcards and other pattern
  679.      matching tokens.  
  680.  
  681.                                     NOTE
  682.  
  683.           You  are not supposed to include the home directory name
  684.           in   the  action  file  specifications  after  the  home
  685.           directory    spec.    I.e.    you   should   not   enter
  686.           `devs:printers/         devs:printers/*HP*',         but
  687.           `devs:printers/ *HP*' is correct.  
  688.  
  689.           The  home  directory  remains active for the rest of the
  690.           command   line   or   until   the  next  home  directory
  691.           specification.  If you want to set the home directory to
  692.           the  current  directory  (as  it is from the beginning),
  693.           use   a   single   slash   (`/')  as  a  home  directory
  694.           specification.  This means you cannot use a single slash
  695.           to  specify  the  parent  directory, to do this you will
  696.           have  to  add  an  additional  slash  (`//' means parent
  697.           directory,  `///'  the  parent's parent directory and so
  698.           on).  
  699.  
  700.  
  701.      2.1.6 Recursive file collection     
  702.  
  703.         When collecting  files recursively (by using the -r option with
  704.      a   or  u  commands),  action  file  specs  are  treated  somewhat
  705.      differently.  Home  directories  work  the  same  way as usual. In
  706.      recursive  file  collection mode, the last node of the action file
  707.      specification  (i.e. the file name part) is used as a pattern that
  708.      is  compared  to  all  files  in  the  specified directory and its
  709.      subdirectories.   Some  examples to hopefully clarify the somewhat
  710.      fuzzy description: 
  711.  
  712.       EXAMPLE 
  713.  
  714.        Example 1: 
  715.  
  716.        lha -r a myarc * 
  717.  
  718.  
  719.  
  720.      
  721.  
  722.  
  723.      V1.11                    LhA User's Guide                  Page 12
  724.  
  725.  
  726.        This  will  add  all  files  in  the  current directory and its
  727.        subdirectories to `myarc.lha'.  
  728.  
  729.        Example 2: 
  730.  
  731.        lha -r a myarc *.c *.cpp 
  732.  
  733.        Will  add  all  `.c'  and `.cpp' files in the current directory
  734.        and its subdirectories to `myarc.lha'.  
  735.  
  736.        Example 3: 
  737.  
  738.        lha -r a myarc ram:work/* hd:tmp/*.c 
  739.  
  740.        Will  add  all  files in `ram:work' and its subdirectories - as
  741.        well  as all `.c' files in `hd:tmp' and its subdirectories - to
  742.        `myarc.lha'.  The  full pathnames will be stored (excluding the
  743.        device specification of course).  
  744.  
  745.        Example 4: 
  746.  
  747.        lha -r a myarc ram:work/ * hd:tmp/ *.c 
  748.  
  749.        Will  do  exactly the same as example 3, but LhA will not store
  750.        the  `ram:work/'  and  `hd:tmp/'  parts of the filenames in the
  751.        archive. (Because of the home directory specifications).  
  752.  
  753.        Example 5: 
  754.  
  755.        lha -r a myarc ram:dir1 ram:makefile 
  756.  
  757.        Will  archive  all  files  in  the  directory  `dir1'  and  its
  758.        subdirectories, as well as the file `ram:makefile'.  
  759.  
  760.        Example 6: 
  761.  
  762.        lha -r a myarc ram:dir1 ram:(makefile) 
  763.  
  764.        Will  do  almost  the  same  as example 5, but will archive ALL
  765.        `makefile's  in  ram:  and  all it's subdirectories (because of
  766.        the parentheses - see note below).  
  767.  
  768.  
  769.                                     NOTE
  770.  
  771.           Explicitly  specified  directories (explicitly = without
  772.           pattern  matching)  will be treated as `dirname/*', i.e.
  773.           all  files  in  the  directory  and it's subdirs will be
  774.           archived.   Explicitly  specified  files  will  only  be
  775.           looked  for  in  the  current home directory, unless the
  776.           filename  is  enclosed in parentheses, in which case the
  777.           file  will  be  looked for recursively. I have chosen to
  778.  
  779.  
  780.      
  781.  
  782.  
  783.      V1.11                    LhA User's Guide                  Page 13
  784.  
  785.  
  786.           implement  it  this  way  because  LhA  can then be used
  787.           better   together   with  directory  utilities  such  as
  788.           Browser or DirectoryOpus.  
  789.  
  790.  
  791.      2.1.7 Specifying destination directory     
  792.  
  793.         You can  optionally  specify  a  destination  directory for the
  794.      files  written  by  the  extract  commands  by writing the desired
  795.      directory  name  anywhere  after  the  archive name on the command
  796.      line.   If no destination directory is specified, LhA will use the
  797.      current  directory  as the destination.  The destination directory
  798.      specification  must  end  in  `:' or `/', just like home directory
  799.      specifications,  or LhA would not be able to distinguish directory
  800.      names from action file specs.  
  801.  
  802.       EXAMPLE 
  803.  
  804.        `lha  x corpus ram:' would extract the contents of `corpus.lzh'
  805.        to ram:.  
  806.  
  807.        `lha  x  project  *.c  dl:tmp/'  would  extract the contents of
  808.        `project.lzh' to the `dl:tmp' directory.  
  809.  
  810.        and so would `lha x project dl:tmp/ *.c'.  
  811.  
  812.                                     NOTE
  813.  
  814.           You  can specify a directory that does not already exist
  815.           as  the  destination,  LhA will automatically create the
  816.           directory for you.  
  817.  
  818.  
  819.      2.1.8 `@'-files       
  820.  
  821.         `@'-files are  files that are treated as if their contents were
  822.      written  on  the command line.  They can be used to specify files,
  823.      options  commands  and  anything  else  can  be  specified  on the
  824.      command  line.   An example would be the command `lha -r e arc.lzh
  825.      *.[chas]  @filelist  ram:', which would extract all files matching
  826.      `*.[chas]'  or  the  files  listed in `filelist' to ram:. Carriage
  827.      returns and linefeeds in `@'-files are treated as whitespace.  
  828.  
  829.      2.1.9 LhA limitations      
  830.  
  831.         LhA has  been  written to be as flexible as possible, but there
  832.      are some limitations that you should be aware of as a user: 
  833.  
  834.      o  LhA pathnames are currently limited to 255 characters.  
  835.  
  836.      o  When  headers  of level 0 are used, filenotes may not be longer
  837.        than  230-{filename  length  (including path)} characters.  With
  838.  
  839.  
  840.      
  841.  
  842.  
  843.      V1.11                    LhA User's Guide                  Page 14
  844.  
  845.  
  846.        header  level  1  or  2  filenotes  may  be up to 255 characters
  847.        (AmigaDOS   currently   only   supports   filenotes  of  max  80
  848.        characters  so  this  should  not  be  any  problem  except with
  849.        exceptionally long filenames and paths).  
  850.  
  851.      o  The  number  of  files  in an archive files are only limited by
  852.        available disk space.  
  853.  
  854.      o  The  number of arguments on the command line is only limited by
  855.        available RAM memory and the used shell.  
  856.  
  857.      o  The  allowed  number  of wildcard-matched files is only limited
  858.        by  available  RAM memory.  Any number of files may be extracted
  859.        or added to an archive in one go.  
  860.  
  861.      o  Level  2 headers must not be longer than 256 characters, or LhA
  862.        will not be able to process them.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.      
  901.  
  902.  
  903.      V1.11                    LhA User's Guide                  Page 15
  904.  
  905.  
  906.      2.3 Pattern matching      
  907.  
  908.         This section  describes  how  LhA  handles pattern matching and
  909.      file  collection.   For  a discussion on what commands will accept
  910.      file   patterns,   please  refer  to  section  2.1  (Command  line
  911.      syntax).  
  912.  
  913.         Pattern matching  in LhA is always case-insensitive.  (i.e.  it
  914.      doesn't  matter  if  you  write  names in upper- or lowercase, `a'
  915.      will match both `a' and `A'.  
  916.  
  917.      2.3.0 Exactly what is pattern matching anyway?  
  918.  
  919.         Pattern matching  is  a means of specifying several files in an
  920.      elegant  and  relatively  straightforward manner.  Instead of just
  921.      lining  up  all  the  file  names you would like to work on on the
  922.      command  line  (which  can be very tedious when a lot of files are
  923.      involved)  you  can  use  a  technique  called `pattern matching'.
  924.      With  this technique you - as the name implies - use the fact that
  925.      the  names  of  the  files you wish to work on often share certain
  926.      characteristics.   For  example,  the  names  of  files containing
  927.      C-source  almost  always  end in `.c', so if you would like to add
  928.      all  C-source  files  in  the  current  directory  you  could take
  929.      advantage  of  this  fact  by specifying a pattern to that matches
  930.      these  files  (in  this  case  such  a  pattern  would  be `*.c').
  931.      Exactly  how  these patterns are built up are explained in section
  932.      2.3.1  forward.  Also read the sections explaining `how to specify
  933.      action files' and `how to specify archive files'.  
  934.  
  935.      2.3.1 Accepted pattern tokens     
  936.  
  937.         LhA accepts  all valid KickStart 2.x and 1.x pattern tokens, it
  938.      also  accepts  all  ARP tokens (works more or less the same way as
  939.      KS2.x).  
  940.  
  941.         In the  explanations  that  follow, the term `expression' means
  942.      either  a  single  token  or character (such as `x' or `?'), or an
  943.      alternation  (such as `(ab|cd|ef)'), or a character class (such as
  944.      `[a-z,A-Z]').  
  945.  
  946.      2.3.1.1 Question mark (?)     
  947.  
  948.         The question  mark  matches  any  one  _single_  character. The
  949.      question mark is sometimes also referred to as the `wildchar'.  
  950.  
  951.       EXAMPLE 
  952.  
  953.        `d?' :  matches  all  two-letter  names  beginning  with  a `d'
  954.               character.  For example `dm' or 'd8'.  
  955.  
  956.        `ab?d' :  matches all four-letter names beginning with `ab' and
  957.               ending  in  `d'.   For example `abcd', `abad' and `ab_d'
  958.  
  959.  
  960.      
  961.  
  962.  
  963.      V1.11                    LhA User's Guide                  Page 16
  964.  
  965.  
  966.               but not `abd' or `acid'.  
  967.  
  968.        `f??' :  matches  all three-letter names beginning in `f'.  For
  969.               example  `foo',  `fel',  `fan'  but  not `ab', `fuga' or
  970.               `fini' 
  971.  
  972.  
  973.      2.3.1.2 Star/Asterisk (*)      
  974.  
  975.  
  976.         The star   matches   any  sequence  of  any  length,  including
  977.      sequences  with  length  zero  (i.e.   the  null string).  The `*'
  978.      character is often called the `wildcard' character.  
  979.  
  980.       EXAMPLE 
  981.  
  982.        `a*' :  matches  all  names  starting  with an `a', for example
  983.               `abba', `anette'.  
  984.  
  985.        `a*z' :  matches `auugaz', `awacz' and `az' and any other names
  986.               starting with an `a' and ending in `z'.  
  987.  
  988.        `s*f*n' :  matches `stefan', `staffan', `steffen', `sfn' or any
  989.               other  name starting with an `s', followed by any number
  990.               (including  zero)  of  arbitrary characters, followed by
  991.               an `f', and ending in `n'.  
  992.  
  993.        `*.lzh' : matches all names ending in `.lzh' 
  994.  
  995.  
  996.      2.3.1.3 Hash mark (#)     
  997.  
  998.         The hash  mark  matches  a subsequent expression (pattern) 0 or
  999.      more  times.   The  simplest  example  of  this is `#?' which will
  1000.      match any filename (equivalent to the `*' token).  
  1001.  
  1002.       EXAMPLE 
  1003.  
  1004.        `#a' :  matches  any name consisting of the `a' character only.
  1005.               For example `aaaa' and `a'.  
  1006.  
  1007.        `b#ad' :  matches  any  name  beginning in `b', followed by any
  1008.               number  (including  0)  of `a' characters, and ending in
  1009.               `d'.  For example `bad', `bd' and `baaaad'.  
  1010.  
  1011.        `#(ha)#(hi)urgh' :  of  `ha':s followed by any number of `hi':s
  1012.               followed   by  `urgh'.  For  example  `hahahahahihiurgh'
  1013.               matches, and so does `haurgh' and `hahiurgh'.  
  1014.  
  1015.  
  1016.      2.3.1.4 Square brackets ([])     
  1017.  
  1018.  
  1019.  
  1020.      
  1021.  
  1022.  
  1023.      V1.11                    LhA User's Guide                  Page 17
  1024.  
  1025.  
  1026.         The square  brackets  enclose  a  set  of  characters to match.
  1027.      They  are  a  bit like the parentheses but match single-characters
  1028.      only.   You can either specify just the letters you would like the
  1029.      expression  to  match,  as in `[abcx]' (this would match `a', `b',
  1030.      `c'  and  `x'), or you can specify ranges, like `[a-c,x-z]' (which
  1031.      would match `a', `b', `c' and `x', `y', `z').  
  1032.  
  1033.       EXAMPLE 
  1034.  
  1035.        `prg.[1-9]' :  matches  any  five-letter  name  beginning  with
  1036.               `prg.',  followed  by  a  non-zero  digit.   For example
  1037.               `prg.1', 'Prg.8'.  
  1038.  
  1039.        `Ver_[1-2].[0-9].[a-z]' :    matches   any   nine-letter   name
  1040.               beginning  with `ver_' followed by either a `1' or a `2'
  1041.               character,  followed by a dot (`.'), a digit and finally
  1042.               a  character  between  `a' and `z' (i.e.  all letters in
  1043.               the   english   alphabet).    For  example  `Ver_1.2.a',
  1044.               `Ver_2.9.d'.  
  1045.  
  1046.        `#[a-z 0-9]'   matches   any  name  containing  any  number  of
  1047.               alphanumeric  characters  (i.e.   either in the alphabet
  1048.               or  numeric).   For  example `ados' or `PDP11'.  It does
  1049.               not  match  `AXE.dat'  however,  since it contains a `.'
  1050.               which is not in the specified character range.  
  1051.  
  1052.        `*.[chas]' :  matches  any  name  ending in `.c', `.h', `.a' or
  1053.               `.s'.  
  1054.  
  1055.  
  1056.      2.3.1.5 Parentheses and the vertical bar   
  1057.  
  1058.         Parentheses can  be  used to achieve several things.  The first
  1059.      way  of  using them is just like in mathematics - to group several
  1060.      individual  expressions into one single expression.  The other way
  1061.      is  to provide a list of acceptable expressions separated with `|'
  1062.      chars.   The  entire  parenthesized  expression  is treated as one
  1063.      token  by other tokens (like `#' and `~').  These two are actually
  1064.      the  same,  since  the  first is just a special case of the second
  1065.      use.  This is easier to explain with a couple of examples: 
  1066.  
  1067.       EXAMPLE 
  1068.  
  1069.        `(abc|def|xyz)' :  will  match names `abc', `def' and `xyz' and
  1070.               no other.  
  1071.  
  1072.        `*.(doc|prf|man)' :  will  match  all  names  ending in `.doc',
  1073.               `.prf' or `.man'.  
  1074.  
  1075.        `~(pfile)' :  will  match  all  names except `pfile'. (NB: this
  1076.               expression  is  NOT  the  same  thing  as  `~pfile', see
  1077.               section 2.3.1.6 for details) 
  1078.  
  1079.  
  1080.      
  1081.  
  1082.  
  1083.      V1.11                    LhA User's Guide                  Page 18
  1084.  
  1085.  
  1086.        `(*.c|*.h|*.doc|ab*)' :  will  match  all files ending in `.c',
  1087.               `.h' or `.doc' and all files beginning with `ab'.  
  1088.  
  1089.  
  1090.         Typing an  action-file  spec of `(xxx|yyy|zzz)' is functionally
  1091.      equivalent  to  writing  `xxx  yyy  zzz' (xxx, yyy, zzz can be any
  1092.      valid patterns, including patterns with parentheses).  
  1093.  
  1094.         Parentheses can be nested.  
  1095.  
  1096.  
  1097.      2.3.1.6 Tilde (~)      
  1098.  
  1099.         The tilde  negates  the  immediately  following expression.  It
  1100.      negates  ONLY  the  immediately  following  token or paranthesized
  1101.      expressiom,  not  the  entire  following expression as some people
  1102.      think.  
  1103.  
  1104.       EXAMPLE 
  1105.  
  1106.        `~x?' :  matches any two-letter name except those starting with
  1107.               `x'.   For  example  `ah',  `ko' or 'ba' but not 'x0' or
  1108.               'xi'.  
  1109.  
  1110.        `~(x?)' :  matches  anything  except  two-letter names starting
  1111.               with  `x'.   For  example  `xaa' or `ab' but not `xa' or
  1112.               'x9'.  
  1113.  
  1114.        `~(#?)' :  matches  nothing  at  all.   (The  tilde negates the
  1115.               `#?', which matches all names).  
  1116.  
  1117.        `~lha' :  matches  all strings that doesn't begin with `l', and
  1118.               ends  in  'ha'.   For  example  `uha', `why_lha' but not
  1119.               'lumbha' or 'lha'.  
  1120.  
  1121.  
  1122.                                     NOTE
  1123.  
  1124.             Because  of  a  bug  (or  misfeature) in ARP, the `~'
  1125.             token  is  not  correctly handled by the generic (KS1
  1126.             and  KS2)  version  of  LhA.  The  KS2.0 only version
  1127.             handles  it  okay however. In ARP a negation actually
  1128.             negates  the ENTIRE EXPRESSION, so `~lha' matches all
  1129.             files but `lha'.  
  1130.  
  1131.  
  1132.      2.3.1.7 Percent sign (%)     
  1133.  
  1134.         The percent   sign  represents  the  empty  string.   i.e.   it
  1135.      matches  0  characters always.  It is only useful in parenthesized
  1136.      expressions  and  must not follow a the `#' token (`#%' would be a
  1137.      rather  pointless  pattern,  since  the % always matches exactly 0
  1138.  
  1139.  
  1140.      
  1141.  
  1142.  
  1143.      V1.11                    LhA User's Guide                  Page 19
  1144.  
  1145.  
  1146.      characters).  
  1147.  
  1148.       EXAMPLE 
  1149.  
  1150.        `lha(.doc|.man|%)' : matches `lha.doc', `lha.man' and `lha'.  
  1151.  
  1152.        `l%u%a' :  matches  `lua'  only;  the percent signs are totally
  1153.               irrelevant here and can just as well be removed.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.      
  1201.  
  1202.  
  1203.      V1.11                    LhA User's Guide                  Page 20
  1204.  
  1205.  
  1206.      2.4 Commands       
  1207.  
  1208.         This section  describes  the  commands for archive manipulation
  1209.      and  maintenance LhA offers to you.  See section 2.1.2 (Specifying
  1210.      commands)  for  details  on how to specify commands on the command
  1211.      line.  
  1212.  
  1213.      2.4.1 `a' Add files to archive   
  1214.  
  1215.         Obviously, this  command  adds a number of files to one or more
  1216.      archives.   If  the specified archive does not already exist, then
  1217.      it  will  be created.  You cannot add files to an archive if these
  1218.      already  exist in the archive.  If you attempt to do so, a warning
  1219.      will  be  issued, but LhA will continue adding the other files you
  1220.      have specified.  
  1221.  
  1222.         Only the  filenames  are  stored  by  default,  if  you want to
  1223.      preserve  some  disk  structure and directory names, you will have
  1224.      to  use the -x option to turn path preservation on. If you want to
  1225.      archive  entire  subdirectories  recursively  you  can  use the -r
  1226.      option,  which  will  turn  on  the -x option automatically. These
  1227.      options are explained in section 2.5.  
  1228.  
  1229.       EXAMPLE 
  1230.  
  1231.        `LhA  a  myarchive  dict.txt'  would add the file `dict.txt' to
  1232.        the archive `myarchive.lha'.  
  1233.  
  1234.        `LhA  a  arc.lzh  *.c *.h' would cause all files in the current
  1235.        directory  ending  in  `.c'  or `.h' to be added to the archive
  1236.        `arc.lzh' 
  1237.  
  1238.        `LhA  -r -0 arch *.c' would cause all `.c' files in the current
  1239.        directory  and  all  it's  subdirectories  to  be  added to the
  1240.        archive  `arch.lzh'  using  the  -lh1-  (LhArc 1.x) compression
  1241.        method.  
  1242.  
  1243.        `LhA  -r  archive  src:(lharca|lha)/*.[cha]  asrc:*.asm'  would
  1244.        cause  all  `.c',  `.h'  and `.a' files in the `src:lharca' and
  1245.        `src:lha'  directories  and  subdirectories,  as  well  as  all
  1246.        `.asm'  files  in  the  `asrc:'  directory,  to be added to the
  1247.        archive `archive.lha'.  
  1248.  
  1249.  
  1250.  
  1251.      2.4.3 `d' Delete files from archive   
  1252.  
  1253.         This command removes one or more files from an archive.  
  1254.  
  1255.  
  1256.                                     NOTE
  1257.  
  1258.  
  1259.  
  1260.      
  1261.  
  1262.  
  1263.      V1.11                    LhA User's Guide                  Page 21
  1264.  
  1265.  
  1266.           Files  deleted  with the `d' command cannot be recovered
  1267.           from  the  archive  file  in  any  way.   Once a file is
  1268.           deleted from an archive it is gone forever.  
  1269.  
  1270.  
  1271.      2.4.4 `e' Extract files from archive   
  1272.  
  1273.         This command  is  used  to  extract  files from an archive.  It
  1274.      works  just  like  the  `x' command, except this command takes the
  1275.      `-x'  option  into  consideration  (the  `x' command assumes it is
  1276.      set).   If  the  `-x'  option  is  disabled,  files  are extracted
  1277.      without  their pathnames, and if it's enabled LhA will extract all
  1278.      files  with  the  pathnames  and  create the needed directories if
  1279.      they do not already exist.  
  1280.  
  1281.       EXAMPLE 
  1282.  
  1283.        `lha  -x0  e  foo.lzh  ram:'  will  extract  all files from the
  1284.        archive  `foo.lzh'  to  ram:,  without paths (all files will be
  1285.        put in the ram:  root directory).  
  1286.  
  1287.        `lha  x foo.lzh *.c ram:' will extract all files ending in `.c'
  1288.        to  ram:,  with  paths  -  i.e.  it  will recreate the original
  1289.        directory structure.  
  1290.  
  1291.        See the tutorial section for more examples 
  1292.  
  1293.  
  1294.      2.4.5 `f' Freshen files in archive   
  1295.  
  1296.         This command  is  used  to  freshen  files in an archive.  I.e.
  1297.      replace  older  files  in  the  archive  with  new  files from the
  1298.      current  directory.   Pathnames  are  considered  unless  the `-x'
  1299.      option  is  disabled  explicitly (with `-x0').  This command never
  1300.      adds  any  files  to an archive, it just replaces those files that
  1301.      have  older modification dates than the corresponding files in the
  1302.      current directory.  
  1303.  
  1304.       EXAMPLE 
  1305.  
  1306.        `lha  f  /aab/lha'  will  freshen  all  files  in  the  archive
  1307.        '/aab/lha.lha'.  
  1308.  
  1309.        `lha  f  /aab/fsys *.[ch]' will freshen all `.c' and `.h' files
  1310.        in the archive '/aab/fsys.lha'.  
  1311.  
  1312.  
  1313.         This command  automatically  enables  the `-x' option unless it
  1314.      is explicitly disabled on the command line with `-x0'.  
  1315.  
  1316.      2.4.8 `l' List archive contents (terse)   
  1317.  
  1318.  
  1319.  
  1320.      
  1321.  
  1322.  
  1323.      V1.11                    LhA User's Guide                  Page 22
  1324.  
  1325.  
  1326.         This command  gives  a terse list of the contents of an archive
  1327.      file,   including   file   names  (without  paths),  original  and
  1328.      compressed length, last modification date and compression ratio.  
  1329.  
  1330.         Files with  pathnames  are  indicated by having a `+' character
  1331.      in front of the name. See example below.  
  1332.  
  1333.         Filenotes are  NOT  displayed  when using this command, use the
  1334.      `v' or `vv' command to display those.  
  1335.  
  1336.         The action  file  specification is used to determine what files
  1337.      to list. If no filespecs are given, all files will be listed.  
  1338.  
  1339.       EXAMPLE 
  1340.  
  1341.         1> lha -N l dl:c64new 
  1342.  
  1343.         Listing of archive 'dl:c64new.lzh': 
  1344.         Original  Packed Ratio    Date     Time    Name 
  1345.         -------- ------- ----- --------- --------  ------------- 
  1346.            36098   26979 25.2% 20-Oct-91 22:40:16 +Stormlord 
  1347.              482     293 39.2% 20-Oct-91 22:41:36 +Stormlord.info 
  1348.            23016   12100 47.4% 21-Oct-91 08:28:18  PlaySID 
  1349.         -------- ------- ----- --------- -------- 
  1350.            59596   39372 33.9% 25-Oct-91 21:22:48   3 files 
  1351.  
  1352.         The `+'  (plus) signs in front of the first two names indicate
  1353.        that  the  file  has a path which is not displayed with the `l'
  1354.        command  (use  the  `v' or `vv' command to display pathnames as
  1355.        well).  The `-N' suppresses the copyright notice.  
  1356.  
  1357.  
  1358.      2.4.9 `m' Move files to archive   
  1359.  
  1360.         This command  works  just  like the `a' command, but the source
  1361.      files are deleted after successfully adding them to the archive.  
  1362.  
  1363.       EXAMPLE 
  1364.  
  1365.        `lha   m  includes.lzh  src:*.[hi]'  will  move  all  files  in
  1366.        directory  `src:'  having  filenames  ending in `.h' or `.i' to
  1367.        the archive `includes.lzh'.  
  1368.  
  1369.        `lha  m  myarc.lzh lhb_log.911012 lhb_idx.911012' will move the
  1370.        two  specified files (`lhb_log.911012' and `lhb_idx.911012') to
  1371.        the archive `myarc.lzh'.  
  1372.  
  1373.  
  1374.      2.4.14 `p' Print files to stdout   
  1375.  
  1376.         This command  works  just like the extract (`e', `x') commands,
  1377.      but  sends the extracted output to stdout (normally the console or
  1378.  
  1379.  
  1380.      
  1381.  
  1382.  
  1383.      V1.11                    LhA User's Guide                  Page 23
  1384.  
  1385.  
  1386.      output redirection file).  
  1387.  
  1388.  
  1389.      2.4.17 `t' Test archive integrity    
  1390.  
  1391.         This command   tests   the   specified  archives  integrity  by
  1392.      extracting  the  files they contain to nowhereland, i.e.  the data
  1393.      is  decompressed only, not written to any file.  This command only
  1394.      works  on  entire archives, i.e.  you cannot just test one file in
  1395.      an  archive.  If this command fails, the archive is corrupted, and
  1396.      a warning return code is returned.  
  1397.  
  1398.       EXAMPLE 
  1399.  
  1400.        `lha  t  work:arcs/*'  will check the integrity of all archives
  1401.        in directory `work:arcs'.  
  1402.  
  1403.        `lha    t   s:envarc.lzh'   will   check   the   integrity   of
  1404.        `s:envarc.lzh' 
  1405.  
  1406.        `lha  -R  t  dh0:*' will check the integrity of all archives on
  1407.        the `dh0:' volume (`-R' = Collect archives recursively).  
  1408.  
  1409.  
  1410.      2.4.18 `u' Update archive     
  1411.  
  1412.         As the  command name implies, this command updates archives. It
  1413.      adds  files  that are not yet in the archive and replaces existing
  1414.      but  older files. The last modification date for files are used to
  1415.      determine which file is the newest one.  
  1416.  
  1417.       EXAMPLE 
  1418.  
  1419.        `lha  u  /aab/lha.lzh  *.c'  will update archive `/aab/lha.lzh'
  1420.        with all `.c' files in the current directory.  
  1421.  
  1422.  
  1423.      2.4.19 `v' List archive (verbose)    
  1424.  
  1425.         This command  works just like the `l' command, but displays the
  1426.      full  pathname  of the file, while `l' only displays the name node
  1427.      without  path.   Another  difference  between `l' and the `v'/`vv'
  1428.      commands  is  that  the  `l'  command  does  not  show  filenotes.
  1429.      Filenotes  are  displayed on a separate line with a colon (`:') in
  1430.      front of it, just like the AmigaDOS `list' command.  
  1431.  
  1432.         The action  file  specification is used to determine what files
  1433.      to list. If no filespecs are given, all files will be listed.  
  1434.  
  1435.       EXAMPLE 
  1436.  
  1437.         1> lha -N v dl:c64new 
  1438.  
  1439.  
  1440.      
  1441.  
  1442.  
  1443.      V1.11                    LhA User's Guide                  Page 24
  1444.  
  1445.  
  1446.  
  1447.         Listing of archive 'dl:c64new.lzh': 
  1448.         Original  Packed Ratio    Date     Time    Name 
  1449.         -------- ------- ----- --------- --------  ------------- 
  1450.            36098   26979 25.2% 20-Oct-91 22:40:16  S/Stormlord 
  1451.              482     293 39.2% 20-Oct-91 22:41:36  S/Stormlord.info 
  1452.            23016   12100 47.4% 21-Oct-91 08:28:18  PlaySID 
  1453.         : New version with `equalizers' 
  1454.         -------- ------- ----- --------- -------- 
  1455.            59596   39372 33.9% 25-Oct-91 21:22:48   3 files 
  1456.  
  1457.         The `-N' suppresses the copyright notice.  
  1458.  
  1459.  
  1460.      2.4.20 `vv' List archive (full)    
  1461.  
  1462.         This command  is  just  like  the `v' command, but displays all
  1463.      available   information  in  a  slightly  different  format.   The
  1464.      original  and  packed size, last modification date and compression
  1465.      ratio   is  listed  just  as  with  the  `v'  command,  plus  file
  1466.      attributes  (`Atts'),  compression method, file CRC and DOS ID for
  1467.      the  OS  the  files  were compressed on.  If no DOS ID is given in
  1468.      the  archive  (header  level  <  1), a question mark is displayed.
  1469.      The  currently  known  DOS  IDs  are `A' and `M', where `A' is for
  1470.      AmigaDOS  and  `M'  is for MS-DOS.  The filename including path is
  1471.      displayed  on  a  separate  line.  File notes are displayed in the
  1472.      same  way as the `v' command does it, on a separate line after the
  1473.      filename.  
  1474.  
  1475.         The action  file  specification is used to determine what files
  1476.      to list. If no filespecs are given, all files will be listed.  
  1477.  
  1478.       EXAMPLE 
  1479.  
  1480.         1> lha -N vv dl:c64new 
  1481.  
  1482.         Listing of archive 'dl:c64new.lzh': 
  1483.         Original  Packed Ratio    Date     Time     Atts   Method CRC  DOS 
  1484.         -------- ------- ----- --------- -------- -------- ------ ---- --- 
  1485.         S/Stormlord 
  1486.            36098   26979 25.2% 20-Oct-91 22:40:16 ----rwed  -lh1- 2093  ? 
  1487.         S/Stormlord.info 
  1488.              482     293 39.2% 20-Oct-91 22:41:36 ----rwed  -lh1- 710E  ? 
  1489.         PlaySID 
  1490.            23016   12100 47.4% 21-Oct-91 08:28:18 ----rwed  -lh5- 89FF  ? 
  1491.         : New version with `equalizers' 
  1492.         -------- ------- ----- --------- -------- 
  1493.            59596   39372 33.9% 25-Oct-91 21:22:48   3 files 
  1494.  
  1495.         The `-N' option suppresses the copyright notice.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.      
  1501.  
  1502.  
  1503.      V1.11                    LhA User's Guide                  Page 25
  1504.  
  1505.  
  1506.        2.4.21 `x' Extract files with path   
  1507.  
  1508.           This command  is  exactly the same as the `e' command, but it
  1509.        always  extracts  files  with paths (i.e.  same as using the `e'
  1510.        command  with  `-x'  option  on), regardless of the state of the
  1511.        `-x' option.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.      
  1561.  
  1562.  
  1563.      V1.11                    LhA User's Guide                  Page 26
  1564.  
  1565.  
  1566.        2.5 Options       
  1567.  
  1568.           This section   describes   the   various   options  that  are
  1569.        available  to  you when using LhA. For a detailed explanation on
  1570.        how  to  enable/disable  specific  options  and  where  you  can
  1571.        specify  options, see section 2.1.1.  The letters in parantheses
  1572.        indicate what commands the options affect.  
  1573.  
  1574.            Code  Commands 
  1575.            ----- ------------ 
  1576.            (add) a,u,f 
  1577.            (all) all commands 
  1578.            (ext) e,x 
  1579.            (upx) a,u,f,e,x 
  1580.            (upd) a,u,f,d 
  1581.  
  1582.  
  1583.        2.5.1 `-a' (upx) Preserve file attributes   
  1584.  
  1585.           This option,  when  enabled,  will make LhA store and restore
  1586.        file protection flags. The eight attributes are listed below: 
  1587.  
  1588.            r:  Read  - This flag is set for files which are readable (a
  1589.               file is read-protected if the flag is unset).  
  1590.  
  1591.            w:  Write  -  This flag is set for files which are writeable
  1592.               (a file is write-protected if the flag is unset).  
  1593.  
  1594.            e:  Execute   -  This  flag  is  set  for  files  which  are
  1595.               executable  (binary load files or shell scripts must have
  1596.               this bit set).  
  1597.  
  1598.            d:  Delete   -   This  flag  is  set  for  files  which  are
  1599.               deleteable  (a  file  is  protected from deletion if this
  1600.               flag is unset).  
  1601.  
  1602.            a:  Archived   -   This  flag  is  used  by  harddisk-backup
  1603.               programs  (and  optionally  LhA)  to  indicate what files
  1604.               have  been changed since the last backup. If this flag is
  1605.               set  it  indicates  that the file is unchanged, and if it
  1606.               is  unset  the  file  has  changed since the last backup.
  1607.               The  bit  is  cleared  whenever  a  write  is made to the
  1608.               file.  
  1609.  
  1610.            p:  Pure  - This flag is set for binary load files which are
  1611.               pure  (i.e.   multitasking  reentrant),  and  can be made
  1612.               resident  with  the  AmigaDOS  'resident'  or  equivalent
  1613.               command.  
  1614.  
  1615.            s:  Script - This flag is set for shell script files.  
  1616.  
  1617.            h:  Hidden  -  This  flag  is  set for files that should not
  1618.  
  1619.  
  1620.      
  1621.  
  1622.  
  1623.      V1.11                    LhA User's Guide                  Page 27
  1624.  
  1625.  
  1626.               show  up  on  directory  listings. It is not supported by
  1627.               the  current  release of the AmigaDOS shell/CLI commands,
  1628.               and should thus not be used.  
  1629.  
  1630.  
  1631.           Please refer   to   an  AmigaDOS  manual  for  more  detailed
  1632.        explanation of the various file protection flags.  
  1633.  
  1634.           If the  option  is  disabled (by issuing `-a0' on the command
  1635.        line),  the  protection  flags  are  set  to  '----RWED' for all
  1636.        extracted  and  archived  files.  Important:  You MUST have this
  1637.        option  enabled  both  when archiving and extracting to preserve
  1638.        file attributes correctly.  
  1639.  
  1640.                                      NOTE
  1641.  
  1642.             Use  this option only if you know that the archive has
  1643.             been  compressed or will be decompressed with an Amiga
  1644.             archiver,   since   the   attribute  field  format  is
  1645.             different  on different operating systems.  If you use
  1646.             archive  headers  of  level  1  or higher you need not
  1647.             care  about  this since the archiver then detects what
  1648.             OS  the  archive  was  created  on  and  only uses the
  1649.             protection  flags  if  it  is  the  native OS.  Always
  1650.             leave  this  option enabled when using archive headers
  1651.             of level 1 and higher! 
  1652.  
  1653.  
  1654.           This option  is  enabled  by default when archiving (a,f,u,m)
  1655.        and disabled by default for all other commands.  
  1656.  
  1657.        2.5.2 `-A' (upd) Set archive attributes   
  1658.  
  1659.           When this  option is active, LhA will set the file protection
  1660.        flags of all archives it updates to `----RW-D'.  
  1661.  
  1662.           This option is OFF by default.  
  1663.  
  1664.        2.5.3 `-b' (all) Set I/O buffer size  
  1665.  
  1666.           This option  will  set  the  size of the I/O buffers LhA uses
  1667.        when  reading  and  writing  to  archive files.  You can set the
  1668.        buffer  size  to  anything  from  8KB  to 64 KB.  Larger buffers
  1669.        normally  makes  LhA  operate  slightly  faster  (depends on the
  1670.        nature of the archive and what files are selected).  
  1671.  
  1672.         EXAMPLE 
  1673.          'lha  -b64  a  archive.lzh hubba' :  Will add file `hubba' to
  1674.          `archive.lzh' using an I/O buffer of 64K.  
  1675.  
  1676.                                      NOTE
  1677.  
  1678.  
  1679.  
  1680.      
  1681.  
  1682.  
  1683.      V1.11                    LhA User's Guide                  Page 28
  1684.  
  1685.  
  1686.             Running  LhA with a small I/O buffer on an accelerated
  1687.             (68020  and  up)  Amiga  will  degrade  compression  /
  1688.             decompression  performance significantly!  The default
  1689.             buffer  size  of  32KB  is  enough  in most cases, and
  1690.             works  well  on  an unaccelerated Amiga as well.  Also
  1691.             note  that when running LhA and doing all work on some
  1692.             ram  disk,  the I/O buffer size is less important, and
  1693.             it  is  unnecessary  to  run  with a large buffer. The
  1694.             default buffer size of 32K is OK for most purposes.  
  1695.  
  1696.  
  1697.           The default buffer size is 32K (32768 bytes) 
  1698.  
  1699.        2.5.5 `-c' (all) Confirm files    
  1700.  
  1701.           When this  option is active LhA will ask you for confirmation
  1702.        on all files and archives that are acted upon.  
  1703.  
  1704.           This option is OFF by default.  
  1705.  
  1706.        2.5.6 `-C' (ext) Clear arc-bit on extract  
  1707.  
  1708.           When this  option  is  active  LhA will mask the A-protection
  1709.        bit  for  all  files it extracts. This is useful when extracting
  1710.        files  from  archives  to  a harddisk, since the extracted files
  1711.        would  not  be  recognized as new or changed files by the backup
  1712.        program if the A-bit was set.  
  1713.  
  1714.           This option is ON by default.  
  1715.  
  1716.        2.5.8 `-D' (all) Alternate progress display   
  1717.  
  1718.           This switch  is  used to change the look of the byte progress
  1719.        indicator   that   LhA   displays  when  it  is  compressing  or
  1720.        decompressing  files.  There  are  several  different  types  of
  1721.        progress  indicators,  you can specify which one you want with a
  1722.        digit after the '-D' string.  
  1723.  
  1724.  
  1725.        0:  This  is  the  default  progress  indicator, it displays how
  1726.           many  bytes of the file LhA has processed, and how many bytes
  1727.           there is in the file like this: 
  1728.  
  1729.           (xxxxxxx/yyyyyyy)  where  x  = bytes processed, and y = total
  1730.           bytes in the file.  
  1731.  
  1732.  
  1733.        1:  This  progress indicator simply shows a `rotating line' that
  1734.           is  rotated  45  degrees  every  time  the progress indicator
  1735.           display is updated).  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.      
  1741.  
  1742.  
  1743.      V1.11                    LhA User's Guide                  Page 29
  1744.  
  1745.  
  1746.        2:  This  progress  indicator shows how many percent of the file
  1747.           LhA has processed.  
  1748.  
  1749.  
  1750.        3:  This   progress   indicator  displays  a  growing  bar  that
  1751.           indicates how much of the file that has been processed.  
  1752.  
  1753.  
  1754.         EXAMPLE 
  1755.  
  1756.          `lha  -D2  a  src  *.asm'  will  add  files  to  the  archive
  1757.          `src.lha' with a percentage indicator (type 2).  
  1758.  
  1759.  
  1760.           The default progress indication type is 0.  
  1761.  
  1762.        2.5.11 `-f' (all) Ignore filenotes    
  1763.  
  1764.           When this  option  is  enabled, LhA will not store or restore
  1765.        any  filenotes.  There is no real need to do this, since it does
  1766.        not  cause any compatibility problems with other systems because
  1767.        of  the  way the filenotes are stored.  If problems should arise
  1768.        anyway,  try  enabling  this option or use headers of level 1 or
  1769.        higher if the target system supports it.  
  1770.  
  1771.           See the  section  about  compatibility (1.7) for a discussion
  1772.        about this and other compatibility issues.  
  1773.  
  1774.           This option  is  OFF  by  default  (filenotes  are stored and
  1775.        restored) 
  1776.  
  1777.        2.5.12 `-F' (all) Use fast progress display  
  1778.  
  1779.           In this  mode LhA uses a different method of display progress
  1780.        for  the  extract  and  test  commands.  Normally,  LhA  emits a
  1781.        linefeed   (LF)   after  each  file  has  been  processed,  thus
  1782.        advancing/scrolling  the display one line. In this mode LhA only
  1783.        emits  a  LF  when  an  error  occurs. This is useful if you are
  1784.        testing  or  extracting files with a lot of small files, and the
  1785.        scrolling takes more time than the actual decompression! 
  1786.  
  1787.                                      NOTE
  1788.  
  1789.             If  you  use  the  default style progress display on a
  1790.             very  fast  Amiga  system  (68020+),  beware  that the
  1791.             scrolling  of  the  screen may actually take more time
  1792.             than  the  actual  decompression!   This is especially
  1793.             true  for  archives  with  many small files.  So don't
  1794.             use  it  unless  you  really  _have_ to see what files
  1795.             have   been   processed.    LhA  scrolls  the  display
  1796.             whenever  an  error occurs on a file, so you still can
  1797.             see  when  an  error  occurs  (better, even, since the
  1798.  
  1799.  
  1800.      
  1801.  
  1802.  
  1803.      V1.11                    LhA User's Guide                  Page 30
  1804.  
  1805.  
  1806.             only  filenames that remain on screen after the action
  1807.             is complete are those that failed!).  
  1808.  
  1809.  
  1810.           This option  is  OFF  by  default  (use  old  style  progress
  1811.        indication).  
  1812.  
  1813.        2.5.16 `-i' (all) Read filelist from file  
  1814.  
  1815.           With this  option  you can include an action file list from a
  1816.        file instead of specifying all action files on a command line.  
  1817.  
  1818.         EXAMPLE 
  1819.  
  1820.          If the file `ArcFList' contains the following lines: 
  1821.  
  1822.          ---> Start of ArcFList data   (this line is NOT in the file) 
  1823.  
  1824.          LhA.c ArcList.c FSys/*.(c|h|i|asm|prf|man|doc|txt) 
  1825.  
  1826.          ---> End of ArcFList data     (this line is NOT in the file) 
  1827.  
  1828.          The following command line: 
  1829.  
  1830.          `lha -iArcFList u /aab/lha.lzh' 
  1831.  
  1832.          Will do the same thing as this command: 
  1833.  
  1834.          `lha        u        /aab/lha.lzh       LhA.c       ArcList.c
  1835.          FSys/*.(c|h|i|asm|prf|man|doc|txt)' 
  1836.  
  1837.  
  1838.                                      NOTE
  1839.  
  1840.               This  command  works  almost  exactly like entering
  1841.               the following command line: 
  1842.  
  1843.               LhA ? ???? @file 
  1844.  
  1845.               Thus  you  can include options in your -i file. The
  1846.               only  difference is that the -i file cannot contain
  1847.               a  destination  directory  specification  while you
  1848.               can  do this with the @file method. The destination
  1849.               directory  will  always  be  taken from the command
  1850.               line when using the -i option.  
  1851.  
  1852.  
  1853.  
  1854.           See the  section  about  `@'(include)-files  for an alternate
  1855.        way of doing this.  
  1856.  
  1857.        2.5.17 `-k' (all) Keep partial files   
  1858.  
  1859.  
  1860.      
  1861.  
  1862.  
  1863.      V1.11                    LhA User's Guide                  Page 31
  1864.  
  1865.  
  1866.  
  1867.           This option  will, if it's enabled, prevent LhA from deleting
  1868.        temporary  files when an error occurs.  Normally temporary files
  1869.        that  fail  the  CRC  check, cause I/O errors or are interrupted
  1870.        with  CTRL-C  are  deleted  before  exiting  LhA  with  an error
  1871.        message,  with  this  option  you  can  force  LhA to keep those
  1872.        (often)  partial  files.   This  can  be  useful  when trying to
  1873.        recover  data  from  corrupted  archives  -  LhA will attempt to
  1874.        extract  the  data  from  the  erraneous  archive file and put a
  1875.        special  filenote on the file to indicate that it failed the CRC
  1876.        check and probably is corrupted.  
  1877.  
  1878.                                      NOTE
  1879.  
  1880.             Please  that  in  the  current  release,  for  certain
  1881.             errors  all data that has been extracted may not be in
  1882.             the  partially extracted file, because of internal I/O
  1883.             buffering.  In  this  case,  set the I/O buffer to the
  1884.             smallest  value  possible  (8KB) to recover as much as
  1885.             possible.  Because  of  this,  small  files may not be
  1886.             recovered  at  all.  This  only applies to LHA (-lh5-)
  1887.             compression,  LhArc  compressed files will always have
  1888.             all extracted data in the partially extracted file.  
  1889.  
  1890.  
  1891.           This option is OFF by default (partial files are deleted).  
  1892.  
  1893.        2.5.18 `-l' (ALL) Make filenames lowercase   
  1894.  
  1895.           This option,  when  active,  will  cause  LhA  to convert all
  1896.        filenames  to  lowercase.   This is useful when extracting files
  1897.        from  archives created on MSDOS systems, whose filenames are all
  1898.        uppercase,  which  look  completely  braindead (IMHO).  Use this
  1899.        option to make them look nicer! 
  1900.  
  1901.         EXAMPLE 
  1902.          `LhA    -l   x   myarc'   will   extract   all   files   from
  1903.          `myarc.(lzh|lha)', making all filenames lowercase.  
  1904.  
  1905.           This option if OFF by default 
  1906.  
  1907.        2.5.19 `-L' (ALL) Create filelist    
  1908.  
  1909.           When this  option  is  enabled, it will cause LhA to create a
  1910.        list  of  the  files  it  has acted upon (i.e. what files in the
  1911.        last  operation  that  matched the action file specification you
  1912.        gave  on  the  command  line).  The  name  of the list file must
  1913.        follow  immediately after the `-L' string. If you need spaces in
  1914.        the filename, enclose the name in double quotes.  
  1915.  
  1916.         EXAMPLE 
  1917.  
  1918.  
  1919.  
  1920.      
  1921.  
  1922.  
  1923.      V1.11                    LhA User's Guide                  Page 32
  1924.  
  1925.  
  1926.          `lha  -Lram:ListFile  d  src.lzh *.asm' will delete all files
  1927.          in  `src.lzh'  with  names ending in `.asm' and create a list
  1928.          of the deleted files in the file `ram:ListFile'.  
  1929.  
  1930.          `lha   -L"ram:List   File"   u  src.lzh  *.asm'  will  update
  1931.          `src.lzh',   and  create  a  list  of  the  files  that  were
  1932.          added/replaced in the file `ram:List File'.  
  1933.  
  1934.                                      NOTE
  1935.  
  1936.             The  file  that  this  option creates is a plain ASCII
  1937.             file  with  every  name  on a separate line. The files
  1938.             created  by this option are suitable for use as action
  1939.             or  exclude  lists  for  LhA  using  the  `@'  or `-i'
  1940.             options.  
  1941.  
  1942.  
  1943.           This option is OFF by default (no filelist created).  
  1944.  
  1945.        2.5.20 `-m' (ALL) No messages for query  
  1946.  
  1947.           When this  option  is  active  LhA  will suppress all queries
  1948.        that  normally  are issued before overwriting existing files for
  1949.        example.   Enabling  this  option  will also cause LhA to ignore
  1950.        TelOps  (autoshow  files).   When this option is on you LhA will
  1951.        behave  like  you  choose  the default action in response to all
  1952.        the  queries  (yes). This option is automatically enabled if the
  1953.        standard  input is not interactive (if run in the background for
  1954.        example).  
  1955.  
  1956.           This option if OFF by default.  
  1957.  
  1958.        2.5.21 `-M' (ext) No autoshow files   
  1959.  
  1960.           When this  option  is  enabled, LhA will suppress the display
  1961.        of autoshow files (files with names ending in `.displayme').  
  1962.  
  1963.                                      NOTE
  1964.  
  1965.             Autoshow  files  are also suppressed if one or more of
  1966.             the `-N', `-q' or `-m' options are enabled.  
  1967.  
  1968.  
  1969.           This option   is   OFF   by   default   (autoshow  files  are
  1970.        displayed).  
  1971.  
  1972.        2.5.22 `-n' (upx) No byte progress indicator  
  1973.  
  1974.           When this  option  is enabled, the byte progress indicator is
  1975.        disabled.  LhA  will  still  display  what file it is working on
  1976.        however, use `-N' to disable all progress indication.  
  1977.  
  1978.  
  1979.  
  1980.      
  1981.  
  1982.  
  1983.      V1.11                    LhA User's Guide                  Page 33
  1984.  
  1985.  
  1986.           This option is OFF by default.  
  1987.  
  1988.        2.5.23 `-N' (all) No progress indicator   
  1989.  
  1990.           This option  is  similar  to  the  `-n' option, but supresses
  1991.        higher-level  progress  indication  (i.e.   the  display of what
  1992.        file  LhA  is  bashing).  It  also  disables the short copyright
  1993.        banner that is printed at each invokation otherwise.  
  1994.  
  1995.           This option  is  off  by  default  (file  progress indication
  1996.        ON).  
  1997.  
  1998.        2.5.25 `-p' (ALL) Pause after loading   
  1999.  
  2000.           When selected,  this  option will cause LhA to pause and wait
  2001.        for  the  user to press any key before executing a command. This
  2002.        is  useful  for  users  with  floppies,  who can then swap disks
  2003.        after LhA has been loaded and is waiting for a keypress.  
  2004.  
  2005.           This option is OFF by default.  
  2006.  
  2007.        2.5.26 `-P' (ALL) Set task priority   
  2008.  
  2009.           This option  is  used  to  set  the LhA process priority. The
  2010.        priority  may  be  set  to  any  value  in  the  range -5 to +5,
  2011.        including  0.  The  higher  priority  you give LhA, the more CPU
  2012.        time  it  will  grab  (processes with lower priority will almost
  2013.        never    get   the   chance   to   run   since   LhA   is   very
  2014.        processor-intensive).   Setting it to a low value (like -5) will
  2015.        make  LhA  only  use  the  processor time that nobody else wants
  2016.        (nice  when  running  LhA  as  a background task while running a
  2017.        comm program).  
  2018.  
  2019.           The priority  must  be  specified  with  a single (optionally
  2020.        prefixed   with  a  minus  sign  for  negative  priority)  digit
  2021.        immediately after the P as in: 
  2022.  
  2023.         EXAMPLE 
  2024.          `lha  -P-1  a  nonsense.lzh  bogus.txt' will make LhA add the
  2025.          file  `bogus.txt'  to  the archive `nonsense.lzh', running at
  2026.          priority -1.  
  2027.  
  2028.           The default  priority  is  inherited from the calling process
  2029.        (i.e.   the CLI or program that called Execute()/RunCommand() ).
  2030.        This is usually zero (0).  
  2031.  
  2032.        2.5.27 `-q' (ALL) Be quiet    
  2033.  
  2034.           This option will supress ALL messages from LhA.  
  2035.  
  2036.           This option is OFF by default 
  2037.  
  2038.  
  2039.  
  2040.      
  2041.  
  2042.  
  2043.      V1.11                    LhA User's Guide                  Page 34
  2044.  
  2045.  
  2046.        2.5.28 `-Q' (ALL) Alternate option set   
  2047.  
  2048.           This option  character  (`Q') will cause all following option
  2049.        characters  until  next  space  character  to  be interpreted as
  2050.        extended  options.   These  are  documented  at  the end of this
  2051.        section.  
  2052.  
  2053.        2.5.29 `-r' (add) Collect action files recursively  
  2054.  
  2055.           When this  option is used, LhA will recursively collect files
  2056.        from subdirectories.  
  2057.         EXAMPLE 
  2058.          `lha  -r a ram:disk1 df0:' will archive all files on the disk
  2059.          in drive 0 to `ram:disk1.lha'.  
  2060.  
  2061.          `lha  -r  a ram:disk2src df0:*.c' will archive all `.c' files
  2062.          on df0: to `ram:disk2src.lha'.  
  2063.  
  2064.          `lha    -r    a    ram:exthup    hd:prg/src/    lha/*.[chasi]
  2065.          lhi/*.[chasi]'  will  add  all  `.c',  `.h', `.a', `.s', `.i'
  2066.          files  in  `hd:prg/src/lha'  and  `hd:prg/src/lhi'  and their
  2067.          subdirectories.  The `hd:prg/src/' part of the names will not
  2068.          be  stored  in  the archive (home directory `hd:prg/src/' was
  2069.          specified).  
  2070.  
  2071.                                      NOTE
  2072.  
  2073.             Files  that are specified explicitly (i.e. without any
  2074.             pattern  matching)  are looked for only in the current
  2075.             (home)   directory,   while   patterns  are  used  for
  2076.             matching  in  all  subdirectories.  If  a directory is
  2077.             specified   explicitly   without  any  following  file
  2078.             pattern  (like  in  `lha -r a ram:test sys:l') it will
  2079.             be  treated as if a `/*' was appended to the directory
  2080.             name  -  i.e.  all  files  in  the  directory and it's
  2081.             subdirectories will be archived.  
  2082.  
  2083.  
  2084.           This option  is  OFF by default. Note that the `-x' option is
  2085.        automatically  enabled when the -r option is used. If you do not
  2086.        want  to  store  pathnames  simply  specify `-x0' on the command
  2087.        line.  
  2088.  
  2089.        2.5.30 `-R' (ALL) Collect archive files recursively  
  2090.  
  2091.           When this  option  is  enabled  LhA  will  search for archive
  2092.        files  recursively using the archive file specification given at
  2093.        the  command  line.  This  works  like  the  `-r' option but for
  2094.        archive files.  
  2095.         EXAMPLE 
  2096.          `lha  -R  l  dh0:files/a*'  will  list  the  contents  of all
  2097.          archive   files   whose  names  begin  in  `a'  in  directory
  2098.  
  2099.  
  2100.      
  2101.  
  2102.  
  2103.      V1.11                    LhA User's Guide                  Page 35
  2104.  
  2105.  
  2106.          `dh0:files' and its subdirectories.  
  2107.  
  2108.          `lha  -R  l *' will list the contents of all archive files in
  2109.          the current directory and its subdirectories.  
  2110.  
  2111.          `lha  -R  l  myarc'  will  list  the contents of all archives
  2112.          called  'myarc.lzh'  or  `myarc.lha' in the current directory
  2113.          and its subdirectories.  
  2114.  
  2115.           This option is OFF by default.  
  2116.  
  2117.        2.5.32 `-S' (add) Set A-flag on archived files 
  2118.  
  2119.           When this  option  is  on,  LhA will set the A (for Archived)
  2120.        file  protection  flag  on  all  files  that  are  added  to  an
  2121.        archive.   This  can  be used to simplify automatic backups when
  2122.        used  together with the -O (Add files without A-flag only).  See
  2123.        section 2.5.24 for more details.  
  2124.  
  2125.           This option is OFF by default.  
  2126.  
  2127.        2.5.33 `-t' (ext) Only new files   
  2128.  
  2129.           When this  option  is  active,  LhA  will  not  overwrite  or
  2130.        replace any files.  
  2131.  
  2132.                                      NOTE
  2133.  
  2134.             This option overrides the `-T' option.  
  2135.  
  2136.  
  2137.           This option is OFF by default.  
  2138.  
  2139.        2.5.34 `-T' (upx) New and newer files  
  2140.  
  2141.           When this  option  is  active,  LhA will overwrite or replace
  2142.        files  that  already exists and are older than the current file,
  2143.        and create files that does not already exist.  
  2144.  
  2145.                                      NOTE
  2146.  
  2147.             This option overrides the `-t' option.  
  2148.  
  2149.  
  2150.           This option is OFF by default.  
  2151.  
  2152.        2.5.35 `-u' (ALL) Make filenames uppercase   
  2153.  
  2154.           This option,  when  active,  will  force  LhA  to convert all
  2155.        filenames   to  uppercase.   This  can  be  useful  when  making
  2156.        archives  that  are supposed to be used on MSDOS-Systems running
  2157.        LhArc/LHA.   While  these have no problems with extracting files
  2158.  
  2159.  
  2160.      
  2161.  
  2162.  
  2163.      V1.11                    LhA User's Guide                  Page 36
  2164.  
  2165.  
  2166.        with  mixed-case  filenames,  the pattern matching routines will
  2167.        not work correctly.  
  2168.  
  2169.           This option is OFF by default.  
  2170.  
  2171.        2.5.36 `-U' (upx) Set update interval   
  2172.  
  2173.           This option  is  used to set the interval (in bytes) at which
  2174.        LhA  updates  the  byte progress indicator. The desired interval
  2175.        must  be expressed in kilobytes, and must immediately follow the
  2176.        `U' character.  
  2177.  
  2178.         EXAMPLE 
  2179.          `LhA  -U4096  a  bar.lzh  *.c' will add all c-source files in
  2180.          the  current directory to `bar.lzh' with a progress indicator
  2181.          interval of 4096 (4K) bytes.  
  2182.  
  2183.          `LhA  -U32768  a bar.lzh *.c' will do the same as the example
  2184.          above, but with a update interval of 32768 bytes (32K).  
  2185.  
  2186.                                      NOTE
  2187.  
  2188.             This  option does currently not affect the update rate
  2189.             of  the  LHA decompression (`-lh5-' compression mode).
  2190.             When  LhA  decompresses  files  with  this compression
  2191.             mode,  the  update  rate  will  be whatever I/O buffer
  2192.             size  is  used  (set with the `-b' option). The reason
  2193.             of   this   behaviour  is  that  the  normal  progress
  2194.             indication would slow down decompression.  
  2195.  
  2196.  
  2197.           The default  update interval is 8192 (8K) bytes for -lh1- and
  2198.        -lh5-  compression  and 4096 (4K) bytes for -lh1- decompression.
  2199.        The  update  rate  for  -lh5- decompression is determined by the
  2200.        I/O buffer size setting (see note above).  
  2201.  
  2202.        2.5.37 `-v' (add) Set compression speed   
  2203.  
  2204.           This option   can   be  used  to  increase  or  decrease  the
  2205.        compression  speed.  -v0 is the slowest, and -v9 is the fastest.
  2206.        As  usual  you  can't  get  anything  for  free,  so compression
  2207.        performance  is  slightly  looser with -v9 than with -v0 but the
  2208.        difference  in  speed  can  be significant (especially with some
  2209.        binary  graphics  data). Higher compression speed is attained by
  2210.        using less statistics in the compression phase.  
  2211.  
  2212.           The default  compression  speed  is  5  -  best in 99% of all
  2213.        cases.  
  2214.  
  2215.        2.5.38 `-w' (upd) Set work directory   
  2216.  
  2217.           This option  is used to specify what directory LhA should use
  2218.  
  2219.  
  2220.      
  2221.  
  2222.  
  2223.      V1.11                    LhA User's Guide                  Page 37
  2224.  
  2225.  
  2226.        to  store  temporary  files.  Temporary  files  are created when
  2227.        adding  files  to  archives, or when updating an archive in some
  2228.        way  (like  deleting  or  freshening  files). The work directory
  2229.        name must be specified immediately after the `-w' string.  
  2230.  
  2231.         EXAMPLE 
  2232.          `LhA   -wrad:tmp  a  MyArc.lzh  *'  will  use  the  directory
  2233.          `rad:tmp'  as  temporary  storage  location  when  adding all
  2234.          files in the current directory to the archive `MyArc.lzh'.  
  2235.  
  2236.           By default  LhA  uses the `T:' directory for temporary files,
  2237.        if  this  assign  or  device  does  not  exist, LhA will use the
  2238.        current directory.  
  2239.  
  2240.        2.5.39 `-x' (all) Preserve and use pathnames  
  2241.  
  2242.           When this  option  is  enabled,  LhA  will  use  and preserve
  2243.        pathnames  when extracting and archiving files. When extracting,
  2244.        LhA  will  create  the  directories that does not already exist.
  2245.        Use  this  option  when  you  want  to  preserve  some directory
  2246.        structure.  This  option  is automatically enabled when the `-r'
  2247.        option is used.  
  2248.  
  2249.           This option  is disabled by default for update operations and
  2250.        enabled by default for extract operations.  
  2251.  
  2252.        2.5.40 `-X' (ALL) Do not append suffix  
  2253.  
  2254.           When this  option  is  enabled, LhA will not append an `.lzh'
  2255.        or  `.lha'  suffix  to  the  given  archive  name.   The default
  2256.        behaviour  is  to append a suffix of `.lha' or `.lzh' (suffix is
  2257.        chosen  depending  on  compression  mode)  if  the name does not
  2258.        already have an extension.  
  2259.  
  2260.           This option is OFF by default (suffixes are appended).  
  2261.  
  2262.        2.5.41 `-Y' (add) Store big files with ratio 
  2263.  
  2264.           When this  option  is  enabled,  LhA  will  store  big  files
  2265.        (>32KB)  without  compression if compression ratio is lower than
  2266.        3%.  This is because extraction times of these files are long on
  2267.        slower machines.  
  2268.  
  2269.           This option is OFF by default (all files are compressed).  
  2270.  
  2271.        2.5.42 `-z' (add) Do not compress files  
  2272.  
  2273.           This option,  when  active,  will  force  LhA  to  store  all
  2274.        updated  or  added  files  in  the archive without attempting to
  2275.        compress  them.   Useful  for  making fast backups where archive
  2276.        size  is  of  no  importance.   It  is not advisable to use this
  2277.        option  when  making  archives  for  distribution  via  modem or
  2278.  
  2279.  
  2280.      
  2281.  
  2282.  
  2283.      V1.11                    LhA User's Guide                  Page 38
  2284.  
  2285.  
  2286.        networks  since  the  archive will end up much larger than if it
  2287.        was compressed.  
  2288.  
  2289.         EXAMPLE 
  2290.          `lha  -z a foo.lha *.bmp' Will store all files in the current
  2291.          directory  with  a  suffix  of  `.bmp'  in  the  archive file
  2292.          `foo.lha' without compressing them.  
  2293.  
  2294.           This option is OFF by default.  
  2295.  
  2296.        2.5.43 `-Z' (add) Compress archives    
  2297.  
  2298.           This option  will  cause  LhA  to attempt compressing already
  2299.        compressed files.  
  2300.  
  2301.           By default,  LhA will not attempt to compress files which are
  2302.        already  compressed (typically archive files or picture files in
  2303.        GIF  or  JPEG  format).  The  file  type  is determined from the
  2304.        suffix,  and  files with names ending in `.lzh', `.lha', `.zoo',
  2305.        `.zip',  `arj',  `.arc', `.dms', `.wrp', `.lhw', `.zap', `.pak',
  2306.        `.pp', `.gif', or `.jpg'.  
  2307.  
  2308.           The reason   why  already  compressed  files  should  not  be
  2309.        compressed  is  that  the  number  of bytes gained by this is so
  2310.        small    that    it    is    not    worth    the    time   spent
  2311.        compressing/decompressing it.  
  2312.  
  2313.           This option is OFF by default.  
  2314.  
  2315.        2.5.45 `-0' (add) Use LhArc 1.x compression  
  2316.  
  2317.           This option  causes  LhA  to  use  the  old -lh1- compression
  2318.        method  when  updating  archives.  This  compression  method  is
  2319.        slightly  faster  than  the  normal  -lh5-  compression  but has
  2320.        looser compression and is much slower to decompress.  
  2321.  
  2322.           When this   compression   mode   is  used,  LhA  defaults  to
  2323.        appending a suffix of `.lzh' when creating archives.  
  2324.  
  2325.           When this  option  is specified, option `-2' is automatically
  2326.        deactivated.  
  2327.  
  2328.           By default the -lh5- compression is used.  
  2329.  
  2330.        2.5.46 `-2' (add) Use LhA compression   
  2331.  
  2332.           This option  causes  LhA  to  use  the  new -lh5- compression
  2333.        method  when  updating  archives.  This  compression  method  is
  2334.        slightly  slower  then the old -lh1- compression but has tighter
  2335.        compression and is much faster to decompress.  
  2336.  
  2337.           When this   compression   mode   is  used,  LhA  defaults  to
  2338.  
  2339.  
  2340.      
  2341.  
  2342.  
  2343.      V1.11                    LhA User's Guide                  Page 39
  2344.  
  2345.  
  2346.        appending a suffix of `.lha' when creating archives.  
  2347.  
  2348.           When this  option  is specified, option `-0' is automatically
  2349.        deactivated.  
  2350.  
  2351.           This is the default compression mode.  
  2352.  
  2353.        2.5.49 `-Qh' (add) Set Huffman buffer size  
  2354.  
  2355.           This option  can  be  used to set the size of the buffer used
  2356.        in  LHA  compression  (default or selected with the `-2' option)
  2357.        for  collecting  statistics. The size of this buffer affects the
  2358.        compression  ratio  in  unpredictable  ways.  As a general rule,
  2359.        keep  this at the default, but if you are compressing homogenous
  2360.        data  with  a  relatively  fixed  relative  frequency of symbols
  2361.        (like  text  files),  setting this to a large value will improve
  2362.        compression.   Binaries generally compress best with the default
  2363.        setting.  
  2364.  
  2365.           The Huffman  buffer may be of any size between 4K and 64K and
  2366.        must  be  specified  immediately  following the `-Qh' string, in
  2367.        kilobytes.  
  2368.  
  2369.         EXAMPLE 
  2370.  
  2371.          `LhA  -Qh32  -2  a  foo.lha *' will compress all files in the
  2372.          current  directory using a Huffman buffer size of 32768 (32K)
  2373.          bytes.  
  2374.  
  2375.          `LhA  -Qh4  -2  a  foo.lha  *' will compress all files in the
  2376.          current  directory  using  a Huffman buffer size of 4096 (4K)
  2377.          bytes.  
  2378.  
  2379.           The default Huffman buffer size is 16K.  
  2380.  
  2381.        2.6 Autoshow files      
  2382.  
  2383.           Autoshow files  are files that are displayed automatically to
  2384.        the   user  when  extracting  the  file  from  an  archive.  LhA
  2385.        determines  if  a  file  should  be  displayed by looking at the
  2386.        filename;  if the filename ends in `.displayme' then the file is
  2387.        displayed  unless  autoshow  files  have been disabled (with the
  2388.        `-M'  option).  Apart  from  being displayed on-screen, autoshow
  2389.        files  are  extracted  just like normal files, without stripping
  2390.        off the `.displayme' part (AmigaDOS LhArc 1.30 does this).  
  2391.  
  2392.        2.7 Residentability       
  2393.  
  2394.           LhA is  multitasking  reentrant  and pure, and it can be made
  2395.        resident  with the standard shell resident commands - `resident'
  2396.        under  AmigaShell  1.3  and 2.0, and `resi' under WShell. If you
  2397.        use   another  shell,  please  refer  to  the  user  manual  for
  2398.  
  2399.  
  2400.      
  2401.  
  2402.  
  2403.      V1.11                    LhA User's Guide                  Page 40
  2404.  
  2405.  
  2406.        information about how to make programs resident.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.      
  2461.  
  2462.  
  2463.      V1.11                    LhA User's Guide                  Page 41
  2464.  
  2465.  
  2466.        4 Politics       
  2467.  
  2468.        4.1 Registration       
  2469.  
  2470.           LhA is  a copyrighted product that has been made available to
  2471.        you  under  the  concept of "Shareware".  It has never been, nor
  2472.        will  it  ever  be  in  the  "Public Domain".  You are granted a
  2473.        limited  license in order to evaluate these programs.  If, after
  2474.        a  3  or  4  week  period of evaluation, you find that LhA suits
  2475.        your  archiving  needs,  please  register.   By cooperating with
  2476.        this  concept  you  help to ensure continued development of this
  2477.        product.  
  2478.  
  2479.           Registered users  will  be  shipped  a  disk  with the latest
  2480.        release  version  of  LhA together with a keyfile. This keyfile,
  2481.        once   copied   to  your  system,  will  disable  the  ShareWare
  2482.        reminders  that always open when you start or quit the Intuition
  2483.        driven  programs  in the LhA family. The registered-user version
  2484.        of  LhA  has all the features of the evaluation version, as well
  2485.        as  several  additional  commands,  options  and features. Among
  2486.        these  are  multi-volume  archive  handling and creation, faster
  2487.        and  better compression, commands to (attempt) repair, split and
  2488.        sort archives, and several other new useful options.  
  2489.  
  2490.           Site license  information  for  commercial and government use
  2491.        can be obtained directly from the author.  
  2492.  
  2493.           No person(s)   or   businesses  other  than  the  author  are
  2494.        authorized  to  accept  any registration or distribution fees in
  2495.        any  form  whatsoever,  except  as specified by the author.  The
  2496.        only  people  who  will  be acknowledged as registered users are
  2497.        those who have sent SEK 100, US, 20 IRC's or more to: 
  2498.  
  2499.                                 Stefan Boberg
  2500.                               Rydsvägen 242 A:25
  2501.                               S-58251 Linköping
  2502.                                Sweden / Europe
  2503.  
  2504.  
  2505.           For residents  in  Sweden,  the  easiest  and cheapest way of
  2506.        transferring  money to the author is by `PostGiro' # 629 22 84-4
  2507.        This  only  costs  8  crowns  and you can write the registration
  2508.        info on the giro-form.  
  2509.  
  2510.           As one  of  the  safest  and  easiest  ways  to  send in your
  2511.        registration  fee  from  other  countries,  I  would  suggest an
  2512.        international  postal money order -- your local post office will
  2513.        be  happy  to  provide you with more information about this.  It
  2514.        also  has  the  advantage  that  the  exchange  of currencies is
  2515.        handled automatically and the surcharge is negligible.  
  2516.  
  2517.           Should the  above  not  work out satisfyingly, you can either
  2518.  
  2519.  
  2520.      
  2521.  
  2522.  
  2523.      V1.11                    LhA User's Guide                  Page 42
  2524.  
  2525.  
  2526.        send  a EuroCheque payable to Stefan Boberg in Swedish Crowns or
  2527.        have  your  bank  transfer  the registration fee to the "Svenska
  2528.        Handelsbanken"  account  145.587.932  "Stefan  Boberg".  Beware:
  2529.        International  transfers  via  banks  are  quite expensive. Bank
  2530.        drafts  are  *NOT*  accepted  as payement since the bank charges
  2531.        outrageous fees (~) from both the sender and the receiver.  
  2532.  
  2533.           In any  case,  be sure to provide me with your name, address,
  2534.        fido-nodenumber/InterNet  address and international phone number
  2535.        for   filing   purposes.  You  can  send  this  information  via
  2536.        electronic  mail,  if  you  wish.   If you don't mind, this data
  2537.        will  be  stored  and  processed in electronic form.  There is a
  2538.        sample   registration   form   you  can  fill  in  in  the  file
  2539.        "OrderForm".  
  2540.  
  2541.           Please allow two to eight weeks for delivery.  
  2542.  
  2543.        4.2 Distribution       
  2544.  
  2545.           Basically, the  evaluation  version of LhA may be distributed
  2546.        freely as long as the following conditions are met: 
  2547.  
  2548.           The distributor  may  only  charge  a  fee up to the costs of
  2549.        obtaining   a  public  domain  diskette  from  Fred  Fish.   The
  2550.        distributor  agrees  to cease distributing the programs and data
  2551.        involved  if  requested to do so by the author.  The distributor
  2552.        may  only distribute an unmodified copy of the original program,
  2553.        with  all  the supplied documentation and copyright notices left
  2554.        intact.  
  2555.  
  2556.           For more details, see the chapter called "License".  
  2557.  
  2558.        4.3 Support       
  2559.  
  2560.           If you  have  any  suggestions,  bug  reports  or  questions,
  2561.        please  contact  the  author  of  LhA  at  the  address given in
  2562.        section 4.1 or at one of the electronic mail addresses below: 
  2563.  
  2564.                  InterNet: boberg@lysator.liu.se 
  2565.                  or      : lha@augs.se 
  2566.                  or      : stefan_boberg@augs.se 
  2567.  
  2568.                  FIDONet : "Stefan Boberg" at node 2:204/404 
  2569.  
  2570.           When sending  in bug reports, please state exactly under what
  2571.        circumstances  the  bug  occurred,  what  equipment was used and
  2572.        what   happened.   If  possible  also  try  to  give  me  enough
  2573.        information  to reproduce the bug.  It is very difficult to find
  2574.        bugs  when  you  don't know exactly what happened.  Please don't
  2575.        just  send  messages  like "it can't extract files from archives
  2576.        sometimes",  that  really  doesn't help me.  If possible, submit
  2577.        the offending file/archive to me so I can test it myself.  
  2578.  
  2579.  
  2580.      
  2581.  
  2582.  
  2583.      V1.11                    LhA User's Guide                  Page 43
  2584.  
  2585.  
  2586.        4.4 Program availability      
  2587.  
  2588.           The latest  version  of LhA is always available for anonymous
  2589.        FTP  at  lysator.liu.se,  in  `/pub/amiga/LhAEval.run' - it is a
  2590.        self-extracting  archive  that  should  be  executed from CLI or
  2591.        WB2.0  to  extract  the contents.  It will also be available for
  2592.        FidoNet  FReq  from  AUGS  BBS  in  Linköping, Sweden, under the
  2593.        magic filename `LHA', the node number is 2:204.404.  
  2594.  
  2595.        4.5 License       
  2596.  
  2597.        1.  This  license  applies to the product called "LhA", a set of
  2598.           programs  for  the  Commodore-Amiga  computer,  published  by
  2599.           Stefan  Boberg  under  the  concepts  of  ShareWare,  and the
  2600.           accompanying  documentation,  example files and anything else
  2601.           that   comes   with  the  original  distribution.  The  terms
  2602.           "Programs"  and  "LhA"  below,  refer  to  this product.  The
  2603.           licensee is addressed as "you".  
  2604.  
  2605.        2.  You   may   copy  and  distribute  verbatim  copies  of  the
  2606.           programs'  executable  code  and documentation as you receive
  2607.           it,  in  any  medium,  provided  that  you  conspicuosly  and
  2608.           appropriately   publish   only   the   original,   unmodified
  2609.           programs,  with  all  copyright  notices  and  disclaimers of
  2610.           warranty   intact   and   including   all   the  accompanying
  2611.           documentation,  example  files  and  anything  else that came
  2612.           with the original.  
  2613.  
  2614.        3.  You  may  not  copy and/or distribute these programs without
  2615.           the  accompanying  documentation  and  other additional files
  2616.           that  came  with  the  original.   You  may  not  copy and/or
  2617.           distribute modified versions of these programs.  
  2618.  
  2619.        4.  You   may   not  copy,  modify,  sublicense,  distribute  or
  2620.           transfer  the  programs  except  as  expressly provided under
  2621.           this   license.   Any  attempt  otherwise  to  copy,  modify,
  2622.           sublicense,  distribute or transfer the programs is void, and
  2623.           will  automatically terminate your rights to use the programs
  2624.           under  this  license.   However,  parties  who  have received
  2625.           copies,  or rights to use copies, from you under this license
  2626.           will  not  have  their  licenses  terminated  so long as such
  2627.           parties remain in full compliance.  
  2628.  
  2629.        5.  By  copying,  distributing  and/or  using  the  programs you
  2630.           indicate  your  acceptance  of this license to do so, and all
  2631.           its terms and conditions.  
  2632.  
  2633.        6.  Each  time  you  redistribute  the  programs,  the recipient
  2634.           automatically  receives  a license from the original licensor
  2635.           to  copy, distribute and/or use the programs subject to these
  2636.           terms  and  conditions.   You  may  not  impose  any  further
  2637.           restrictions  on  the  recipients'  exercise  of  the  rights
  2638.  
  2639.  
  2640.      
  2641.  
  2642.  
  2643.      V1.11                    LhA User's Guide                  Page 44
  2644.  
  2645.  
  2646.           granted herein.  
  2647.  
  2648.        7.  You  may  not disassemble, decompile, re-source or otherwise
  2649.           reverse engineer the programs.  
  2650.  
  2651.        8.  You  may  use the programs for a period of up to 30 days for
  2652.           evaluation.  After that, you have to register.  
  2653.  
  2654.        9.  If  you wish to incorporate parts of the programs into other
  2655.           programs, write to the author to ask for permission.  
  2656.  
  2657.        10.  You  agree  to  cease  distributing  the  programs and data
  2658.           involved if requested to do so by author.  
  2659.  
  2660.        11.  You  may  charge  a fee to recover distribution costs.  The
  2661.           fee  for  diskette distribution may not be more than the cost
  2662.           to obtain a public domain diskette from Fred Fish.  
  2663.  
  2664.  
  2665.        4.6 Disclaimer       
  2666.  
  2667.           THERE IS   NO  WARRANTY  FOR  THE  PROGRAMS,  TO  THE  EXTENT
  2668.        PERMITTED  BY  APPLICABLE  LAW.  EXCEPT WHEN OTHERWISE STATED IN
  2669.        WRITING  THE  COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE
  2670.        PROGRAMS  "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  2671.        OR   IMPLIED,   INCLUDING,  BUT  NOT  LIMITED  TO,  THE  IMPLIED
  2672.        WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR  A PARTICULAR
  2673.        PURPOSE.   THE  ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF
  2674.        THE  PROGRAMS IS WITH YOU.  SHOULD THE PROGRAMS PROVE DEFECTIVE,
  2675.        YOU  ASSUME  THE  COST  OF  ALL  NECESSARY  SERVICING, REPAIR OR
  2676.        CORRECTION.  
  2677.  
  2678.           IN NO  EVENT  UNLESS  REQUIRED BY APPLICABLE LAW OR AGREED TO
  2679.        IN  WRITING  WILL  ANY  COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO
  2680.        MAY  REDISTRIBUTE  THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE TO
  2681.        YOU  FOR  DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  2682.        CONSEQUENTIAL  DAMAGES  ARISING  OUT  OF THE USE OR INABILITY TO
  2683.        USE  THE  PROGRAMS (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
  2684.        DATA  BEING  RENDERED  INACCURATE  OR LOSSES SUSTAINED BY YOU OR
  2685.        THIRD  PARTIES  OR A FAILURE OF THE PROGRAMS TO OPERATE WITH ANY
  2686.        OTHER  PROGRAMS),  EVEN  IF  SUCH HOLDER OR OTHER PARTY HAS BEEN
  2687.        ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.      
  2701.  
  2702.  
  2703.      V1.11                    LhA User's Guide                  Page 45
  2704.  
  2705.  
  2706.        5 Acknowledgements       
  2707.  
  2708.        Haruyasu Yoshizaki  For releasing the source of the original LHA
  2709.                             for  MSDOS.   The  source  was  used  as  a
  2710.                             reference  when  writing  this  program. No
  2711.                             actual  code  was  copied from this source,
  2712.                             rather  LhA  was  written  from scratch for
  2713.                             the Amiga.  
  2714.  
  2715.        Haruhiko Okumura  For  devising  the -lh5- and -lh4- compression
  2716.                             algorithms,  and for releasing the C source
  2717.                             for  these  to  the  public  domain.  These
  2718.                             sources  were  used  as  a  reference  when
  2719.                             writing  the  680x0  assembler  versions of
  2720.                             the  compression  and  decompression  code.
  2721.                             Some  algorithms were replaced with my own,
  2722.                             faster ones.  
  2723.  
  2724.        Robert K.Jung  For making the feature-packed ARJ for MSDOS, from
  2725.                             which   several   ideas  for  commands  and
  2726.                             features was included in LhA.  
  2727.  
  2728.        Paolo Zibetti  For making the first LhArc-style archiver for the
  2729.                             Amiga,  which  made  me  interested in file
  2730.                             archivers  and  advanced  data  compression
  2731.                             techniques.  
  2732.  
  2733.        Jonathan Forbes  For making the -lh1- compression routines of LZ
  2734.                             slightly  faster  than those of my previous
  2735.                             (unfinished)  program  `LhArcA'.   This was
  2736.                             one  of  the  reasons  that  made  me start
  2737.                             writing  this  program.  Another reason for
  2738.                             writing   LhA   was   that   LZ   had  some
  2739.                             misfeatures and did not work as intended.  
  2740.  
  2741.        Ron Birk  For  digging  out  the  source codes I needed before I
  2742.                             gained access to InterNet myself - Thanks! 
  2743.  
  2744.        Thomas Olsson For supplying me with the source for LhA V2.11.  
  2745.  
  2746.        LhArcA users  Big thanks to all of you who registered for LhArcA
  2747.                             and  LhA  even  before  the  programs  were
  2748.                             finished  (LhArcA  never was, but those who
  2749.                             registered  will  receive LhI/LhA when it's
  2750.                             finished).  
  2751.  
  2752.        LhA users  Big  thanks  to all who registered for LhA V1.00, and
  2753.                             even  bigger  thanks  to those who reported
  2754.                             bugs   and   problems   with  the  previous
  2755.                             releases  -  without you this program would
  2756.                             never be what it is now.  
  2757.  
  2758.  
  2759.  
  2760.      
  2761.  
  2762.  
  2763.      V1.11                    LhA User's Guide                  Page 46
  2764.  
  2765.  
  2766.  
  2767.           The license  agreement  was  heavily inspired by the TrapDoor
  2768.        license,  which in turn was inspired by Jack Radigan and the GNU
  2769.        General public License.  
  2770.  
  2771.           The manual  was  formatted with a modified version of `proff'
  2772.        (originally  written  for  VAX/VMS/MSDOS  by  Ozan S.  Yigit and
  2773.        Steven Tress).  
  2774.  
  2775.           The program  was  developed  using the Lattice C Compiler and
  2776.        Assembler   on   a  25MHz  Amiga  3000.  Great  compiler,  great
  2777.        computer! 
  2778.  
  2779.           Inspiration provided  (in  order  of  significance) by Linda,
  2780.        Depeche  Mode,  Pet  Shop  Boys,  Erasure,  OMD, Electronic, The
  2781.        KLF/JAMS, Yazoo, Tears for Fears, Simple Minds and Kraftwerk.  
  2782.  
  2783.  
  2784.  
  2785.                     ... Post aspera grata ...  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.      
  2821.  
  2822.  
  2823.      
  2824.  
  2825.  
  2826.                               Table Of Contents
  2827.  
  2828.                                   LhA V1.11
  2829.  
  2830.        1 - Introduction     .....................................    1
  2831.           1.1 About the manual    ...............................    1
  2832.           1.2 System requirements     ...........................    1
  2833.           1.4 Terminology      ..................................    1
  2834.           1.5 LhA - what is it?  ................................    2
  2835.           1.6 What is a file archiver anyway? ...................    2
  2836.           1.7 Why should I use LhA?  ............................    4
  2837.              1.7.1 How fast is it?   ............................    4
  2838.           1.8 Compatibility and Amiga-specific features   .......    6
  2839.           1.9 About the author program history and future........    7
  2840.        2 Reference guide     ....................................    9
  2841.           2.1 Command line syntax    ............................    9
  2842.              2.1.1 Specifying options     .......................    9
  2843.              2.1.2 Specifying commands     ......................    9
  2844.              2.1.3 Specifying archives     ......................   10
  2845.              2.1.4 Specifying action files    ...................   10
  2846.              2.1.5 Home directories     .........................   10
  2847.              2.1.6 Recursive file collection    .................   11
  2848.              2.1.7 Specifying destination directory    ..........   13
  2849.              2.1.8 `@'-files      ...............................   13
  2850.              2.1.9 LhA limitations     ..........................   13
  2851.           2.3 Pattern matching     ..............................   15
  2852.              2.3.0 Exactly what is pattern matching anyway? .....   15
  2853.              2.3.1 Accepted pattern tokens    ...................   15
  2854.                 2.3.1.1 Question mark (?)    ....................   15
  2855.                 2.3.1.2 Star/Asterisk (*)     ...................   16
  2856.                 2.3.1.3 Hash mark (#)    ........................   16
  2857.                 2.3.1.4 Square brackets ([])    .................   16
  2858.                 2.3.1.5 Parentheses and the vertical bar  .......   17
  2859.                 2.3.1.6 Tilde (~)     ...........................   18
  2860.                 2.3.1.7 Percent sign (%)    .....................   18
  2861.           2.4 Commands      .....................................   20
  2862.              2.4.1 `a' Add files to archive  ....................   20
  2863.              2.4.3 `d' Delete files from archive  ...............   20
  2864.              2.4.4 `e' Extract files from archive  ..............   21
  2865.              2.4.5 `f' Freshen files in archive  ................   21
  2866.              2.4.8 `l' List archive contents (terse)  ...........   21
  2867.              2.4.9 `m' Move files to archive  ...................   22
  2868.              2.4.14 `p' Print files to stdout  ..................   22
  2869.              2.4.17 `t' Test archive integrity   ................   23
  2870.              2.4.18 `u' Update archive    .......................   23
  2871.              2.4.19 `v' List archive (verbose)   ................   23
  2872.              2.4.20 `vv' List archive (full)   ..................   24
  2873.              2.4.21 `x' Extract files with path  ................   24
  2874.           2.5 Options      ......................................   26
  2875.              2.5.1 `-a' (upx) Preserve file attributes  .........   26
  2876.              2.5.2 `-A' (upd) Set archive attributes  ...........   27
  2877.              2.5.3 `-b' (all) Set I/O buffer size ...............   27
  2878.  
  2879.  
  2880.                                     - I -
  2881.  
  2882.  
  2883.      
  2884.  
  2885.  
  2886.              2.5.5 `-c' (all) Confirm files   ...................   28
  2887.              2.5.6 `-C' (ext) Clear arc-bit on extract ..........   28
  2888.              2.5.8 `-D' (all) Alternate progress display  .......   28
  2889.              2.5.11 `-f' (all) Ignore filenotes   ...............   29
  2890.              2.5.12 `-F' (all) Use fast progress display ........   29
  2891.              2.5.16 `-i' (all) Read filelist from file ..........   30
  2892.              2.5.17 `-k' (all) Keep partial files  ..............   30
  2893.              2.5.18 `-l' (ALL) Make filenames lowercase  ........   31
  2894.              2.5.19 `-L' (ALL) Create filelist   ................   31
  2895.              2.5.20 `-m' (ALL) No messages for query ............   32
  2896.              2.5.21 `-M' (ext) No autoshow files  ...............   32
  2897.              2.5.22 `-n' (upx) No byte progress indicator .......   32
  2898.              2.5.23 `-N' (all) No progress indicator  ...........   33
  2899.              2.5.25 `-p' (ALL) Pause after loading  .............   33
  2900.              2.5.26 `-P' (ALL) Set task priority  ...............   33
  2901.              2.5.27 `-q' (ALL) Be quiet   .......................   33
  2902.              2.5.28 `-Q' (ALL) Alternate option set  ............   33
  2903.              2.5.29 `-r' (add) Collect action files recursively .   34
  2904.              2.5.30 `-R' (ALL) Collect archive files recursively    34
  2905.              2.5.32 `-S' (add) Set A-flag on archived files......   35
  2906.              2.5.33 `-t' (ext) Only new files  ..................   35
  2907.              2.5.34 `-T' (upx) New and newer files ..............   35
  2908.              2.5.35 `-u' (ALL) Make filenames uppercase  ........   35
  2909.              2.5.36 `-U' (upx) Set update interval  .............   36
  2910.              2.5.37 `-v' (add) Set compression speed  ...........   36
  2911.              2.5.38 `-w' (upd) Set work directory  ..............   36
  2912.              2.5.39 `-x' (all) Preserve and use pathnames .......   37
  2913.              2.5.40 `-X' (ALL) Do not append suffix .............   37
  2914.              2.5.41 `-Y' (add) Store big files with ratio........   37
  2915.              2.5.42 `-z' (add) Do not compress files ............   37
  2916.              2.5.43 `-Z' (add) Compress archives   ..............   38
  2917.              2.5.45 `-0' (add) Use LhArc 1.x compression ........   38
  2918.              2.5.46 `-2' (add) Use LhA compression  .............   38
  2919.              2.5.49 `-Qh' (add) Set Huffman buffer size .........   39
  2920.           2.6 Autoshow files     ................................   39
  2921.           2.7 Residentability      ..............................   39
  2922.        4 Politics      ..........................................   41
  2923.           4.1 Registration      .................................   41
  2924.           4.2 Distribution      .................................   42
  2925.           4.3 Support      ......................................   42
  2926.           4.4 Program availability     ..........................   42
  2927.           4.5 License      ......................................   43
  2928.           4.6 Disclaimer      ...................................   44
  2929.        5 Acknowledgements      ..................................   45
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.                                     - II -
  2941.  
  2942.